ezux 1.1.13 → 1.1.18

package/dist/components/EzScheduler/views/DayWeekView.d.ts

@@ -0,0 +1,177 @@
+import { default as React } from 'react';
+import { SchedulerEvent, Resource, ViewType, GroupModel } from '../EzScheduler.types';
+import { Virtualizer } from '@tanstack/react-virtual';
+/**
+ * Props for the DayWeekView component.
+ */
+interface DayWeekViewProps {
+    /**
+     * List of days to display in the view.
+     * @group Properties
+     */
+    daysInView: Date[];
+    /**
+     * List of events to display.
+     * @group Properties
+     */
+    visibleEvents: SchedulerEvent[];
+    /**
+     * Virtualizer for efficient row rendering.
+     * @group Properties
+     */
+    rowVirtualizer: Virtualizer<HTMLDivElement, Element>;
+    /**
+     * List of resources to display as columns (in day view).
+     * @group Properties
+     */
+    resources?: Resource[];
+    /**
+     * Whether to show resources as separate columns in day view.
+     * @group Properties
+     */
+    showResourcesInDayView?: boolean;
+    /**
+     * Callback when a slot is clicked.
+     * @group Events
+     */
+    onSlotClick?: (date: Date, resourceId?: string) => void;
+    /**
+     * Callback when a slot is double-clicked.
+     * @group Events
+     */
+    onSlotDoubleClick?: (date: Date, resourceId?: string) => void;
+    /**
+     * Callback when an event is clicked.
+     * @group Events
+     */
+    onEventClick?: (event: SchedulerEvent) => void;
+    /**
+     * Callback when an event is double-clicked.
+     * @group Events
+     */
+    onEventDoubleClick?: (event: SchedulerEvent) => void;
+    /**
+     * Callback when an event is deleted.
+     * @group Events
+     */
+    onEventDelete?: (eventId: string) => void;
+    /**
+     * ID of the currently active event.
+     * @group Properties
+     */
+    activeEventId?: string;
+    /**
+     * Reference to the scroll container.
+     * @group Properties
+     */
+    scrollRef?: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Callback when the view mode changes.
+     * @group Events
+     */
+    onViewChange?: (view: ViewType) => void;
+    /**
+     * Callback when the selected date changes.
+     * @group Events
+     */
+    onDateChange?: (date: Date) => void;
+    /**
+     * Locale for date formatting.
+     * @group Properties
+     */
+    locale?: string;
+    /**
+     * Callback when a range is selected.
+     * @group Events
+     */
+    onRangeSelect?: (start: Date, end: Date, resourceId?: string, position?: {
+        x: number;
+        y: number;
+    }) => void;
+    /**
+     * Template for the date header.
+     * @group Models
+     */
+    dateHeaderTemplate?: string | ((props: any) => React.ReactNode);
+    /**
+     * Whether to show week numbers.
+     * @group Properties
+     */
+    showWeekNumber?: boolean;
+    /**
+     * Rule for calculating week numbers.
+     * @group Properties
+     */
+    weekRule?: 'FirstDay' | 'FirstFourDayWeek' | 'FirstFullWeek';
+    /**
+     * Time formatting string (e.g., "HH:mm").
+     * @group Properties
+     */
+    timeFormat?: string;
+    /**
+     * Template for cells.
+     * @group Models
+     */
+    cellTemplate?: (data: any) => React.ReactNode;
+    /**
+     * Whether to enable HTML sanitization for templates.
+     * @group Properties
+     */
+    enableHtmlSanitizer?: boolean;
+    /**
+     * Callback when hovering over an event.
+     * @group Events
+     */
+    hover?: (event: SchedulerEvent) => void;
+    /**
+     * Whether to show an unassigned lane for events without a resource.
+     * @group Properties
+     */
+    showUnassignedLane?: boolean;
+    /**
+     * Start hour for the view (e.g., "08:00").
+     * @group Properties
+     */
+    startHour?: string;
+    /**
+     * End hour for the view (e.g., "18:00").
+     * @group Properties
+     */
+    endHour?: string;
+    /**
+     * Duration of each slot in minutes.
+     * @group Properties
+     */
+    slotDuration?: number;
+    /**
+     * Use 24-hour time format.
+     * @group Properties
+     */
+    is24Hour?: boolean;
+    /**
+     * Callback to toggle 24-hour time format.
+     * @group Methods
+     */
+    setIs24Hour?: (is24: boolean) => void;
+    /**
+     * Grouping configuration.
+     * @group Models
+     */
+    group?: GroupModel;
+    /**
+     * Callback for cell context menu.
+     * @group Events
+     */
+    onCellContextMenu?: (args: {
+        date: Date;
+        x: number;
+        y: number;
+    }) => void;
+    /**
+     * Text direction.
+     * @group Appearance
+     */
+    dir?: 'ltr' | 'rtl' | 'auto';
+}
+export declare const DayWeekView: React.FC<DayWeekViewProps>;
+export {};

package/dist/components/EzScheduler/views/MonthView.d.ts

@@ -0,0 +1,60 @@
+import { SchedulerEvent } from '../EzScheduler.types';
+/**
+ * Props for the MonthView component.
+ */
+interface MonthViewProps {
+    /**
+     * The currently displayed date.
+     * @group Properties
+     */
+    currentDate: Date;
+    /**
+     * List of days to display in the grid.
+     * @group Properties
+     */
+    daysInView: Date[];
+    /**
+     * List of events to display.
+     * @group Properties
+     */
+    visibleEvents: SchedulerEvent[];
+    /**
+     * Callback when a slot is clicked.
+     * @group Events
+     */
+    onSlotClick?: (date: Date) => void;
+    /**
+     * Callback when a slot is double-clicked.
+     * @group Events
+     */
+    onSlotDoubleClick?: (date: Date) => void;
+    /**
+     * Callback when an event is clicked.
+     * @group Events
+     */
+    onEventClick?: (event: SchedulerEvent) => void;
+    /**
+     * Callback when the "more events" indicator is clicked.
+     * @group Events
+     */
+    moreEventsClick?: (data: {
+        date: Date;
+        event?: SchedulerEvent;
+    }) => void;
+    /**
+     * Number of months to display.
+     * @group Properties
+     */
+    monthsCount?: number;
+    /**
+     * Text direction.
+     * @group Appearance
+     */
+    dir?: 'ltr' | 'rtl' | 'auto';
+}
+/**
+ * A monthly grid view of events.
+ * @group Views
+ */
+export declare const MonthView: React.FC<MonthViewProps>;
+export {};

package/dist/components/EzScheduler/views/TimelineView.d.ts

@@ -0,0 +1,116 @@
+import { default as React } from 'react';
+import { SchedulerEvent, Resource, ViewType, GroupModel } from '../EzScheduler.types';
+/**
+ * Props for the TimelineView component.
+ */
+interface TimelineViewProps {
+    /**
+     * The type of timeline view (day, week, month).
+     * @group Properties
+     */
+    view: ViewType;
+    /**
+     * The currently displayed date.
+     * @group Properties
+     */
+    currentDate: Date;
+    /**
+     * List of days to display in the timeline.
+     * @group Properties
+     */
+    daysInView: Date[];
+    /**
+     * List of events to display.
+     * @group Properties
+     */
+    visibleEvents: SchedulerEvent[];
+    /**
+     * List of resources to display as lanes.
+     * @group Properties
+     */
+    resources?: Resource[];
+    /**
+     * Callback when a slot is clicked.
+     * @group Events
+     */
+    onSlotClick?: (date: Date, resourceId?: string) => void;
+    /**
+     * Callback when a slot is double-clicked.
+     * @group Events
+     */
+    onSlotDoubleClick?: (date: Date, resourceId?: string) => void;
+    /**
+     * Callback when an event is clicked.
+     * @group Events
+     */
+    onEventClick?: (event: SchedulerEvent) => void;
+    /**
+     * Callback when an event is deleted.
+     * @group Events
+     */
+    onEventDelete?: (eventId: string) => void;
+    /**
+     * Callback when a range is selected.
+     * @group Events
+     */
+    onRangeSelect?: (start: Date, end: Date, resourceId?: string, position?: {
+        x: number;
+        y: number;
+    }) => void;
+    /**
+     * Whether to show the current time indicator.
+     * @group Properties
+     */
+    currentTimeIndicator?: boolean;
+    /**
+     * Whether to show resource header names.
+     * @group Properties
+     */
+    showResourceHeaders?: boolean;
+    /**
+     * Grouping configuration.
+     * @group Models
+     */
+    group?: GroupModel;
+    /**
+     * Whether to show an unassigned lane for events without a resource.
+     * @group Properties
+     */
+    showUnassignedLane?: boolean;
+    /**
+     * Start hour for the timeline (e.g., "08:00").
+     * @group Properties
+     */
+    startHour?: string;
+    /**
+     * End hour for the timeline (e.g., "18:00").
+     * @group Properties
+     */
+    endHour?: string;
+    /**
+     * Duration of each slot in minutes.
+     * @group Properties
+     */
+    slotDuration?: number;
+    /**
+     * Use 24-hour time format.
+     * @group Properties
+     */
+    is24Hour?: boolean;
+    /**
+     * Reference to the scroll container for external control and auto-scrolling.
+     * @group Properties
+     */
+    scrollRef?: React.RefObject<HTMLDivElement | null>;
+    /**
+     * Text direction.
+     * @group Appearance
+     */
+    dir?: 'ltr' | 'rtl' | 'auto';
+}
+/**
+ * A horizontal timeline view with resource lanes.
+ * @group Views
+ */
+export declare const TimelineView: React.FC<TimelineViewProps>;
+export {};

package/dist/components/EzSignature/EzSignature.d.ts

@@ -0,0 +1,42 @@
+import { default as React } from 'react';
+import { EzSignatureProps, EzSignatureRef } from './EzSignature.types';
+/**
+ * EzSignature is a high-fidelity digital ink and signature capture engine.
+ * It provides a smooth, pressure-sensitive drawing experience using SVG
+ * and perfect-freehand algorithms, suitable for legal and formal validations.
+ *
+
+ * ### Key Features
+ * - **Natural Ink Flow**: Advanced smoothing and streamlining for professional-looking signatures.
+ * - **Pressure Sensitivity**: Dynamically adjusts stroke width based on pointer pressure.
+ * - **Multi-Format Export**: Save signatures as high-resolution `PNG`, `JPEG`, or vector `SVG`.
+ * - **Vector Persistence**: Stores signatures as geometric point data for lossless scaling and reproduction.
+ * - **Undo/Redo Stack**: Full transactional history for correcting mistakes during capture.
+ * - **Theme Aware**: Automatically adjusts stroke colors based on active theme or custom palettes.
+ *
+ * ### Minimal Example
+ * ```tsx
+ * <EzSignature
+ *   width={400}
+ *   height={200}
+ *   onSave={(dataUrl) => submitSignature(dataUrl)}
+ * />
+ * ```
+ *
+ * ### Imperative Control
+ * ```tsx
+ * const sigRef = useRef<EzSignatureRef>(null);
+ *
+ * return (
+ *   <>
+ *     <EzSignature ref={sigRef} />
+ *     <button onClick={() => sigRef.current?.clear()}>Clear</button>
+ *     <button onClick={() => sigRef.current?.save('png')}>Download</button>
+ *   </>
+ * );
+ * ```
+ *
+ * @group Core Components
+ */
+declare const EzSignature: React.ForwardRefExoticComponent<EzSignatureProps & React.RefAttributes<EzSignatureRef>>;
+export default EzSignature;

package/dist/components/EzSignature/EzSignature.types.d.ts

@@ -0,0 +1,132 @@
+import { SharedBaseProps } from '../../shared/types/BaseProps';
+/**
+ * Props for the EzSignature component.
+ * @group Properties
+ */
+export interface EzSignatureProps extends SharedBaseProps {
+    /**
+     * Width of the signature canvas.
+     * @default '100%'
+     * @group Properties
+     */
+    width?: string | number;
+    /**
+     * Height of the signature canvas.
+     * @default 300
+     * @group Properties
+     */
+    height?: string | number;
+    /**
+     * Background color of the signature pad.
+     * @default 'transparent'
+     * @group Properties
+     */
+    backgroundColor?: string;
+    /**
+     * Stroke color of the signature.
+     * @default 'currentColor' (uses theme foreground)
+     * @group Properties
+     */
+    strokeColor?: string;
+    /**
+     * Minimum stroke width.
+     * @default 2
+     * @group Properties
+     */
+    minStrokeWidth?: number;
+    /**
+     * Maximum stroke width.
+     * @default 4
+     * @group Properties
+     */
+    maxStrokeWidth?: number;
+    /**
+     * Factor to smooth the stroke.
+     * @default 0.5
+     * @group Properties
+     */
+    smoothing?: number;
+    /**
+     * Effect of pressure on the stroke's size.
+     * @default 0.5
+     * @group Properties
+     */
+    thinning?: number;
+    /**
+     * Callback when signature stroke ends.
+     * @group Events
+     */
+    onEnd?: (event: React.PointerEvent<SVGSVGElement>) => void;
+    /**
+     * Callback when signature changes (after each stroke).
+     * @group Events
+     */
+    onChange?: (signature: string[]) => void;
+    /**
+     * Callback when signature is saved.
+     * @group Events
+     */
+    onSave?: (signature: string, format: string) => void;
+    /**
+     * Read only mode.
+     * @group Properties
+     */
+    readOnly?: boolean;
+    /**
+     * Disabled mode.
+     * @group Properties
+     */
+    disabled?: boolean;
+}
+/**
+ * Imperative API for EzSignature.
+ * @group Methods
+ */
+export interface EzSignatureRef {
+    /**
+     * Clears the signature pad.
+     * @group Methods
+     */
+    clear: () => void;
+    /**
+     * Undoes the last stroke.
+     * @group Methods
+     */
+    undo: () => void;
+    /**
+     * Redoes the last undone stroke.
+     * @group Methods
+     */
+    redo: () => void;
+    /**
+     * Checks if undo is possible.
+     * @group Methods
+     */
+    canUndo: () => boolean;
+    /**
+     * Checks if redo is possible.
+     * @group Methods
+     */
+    canRedo: () => boolean;
+    /**
+     * Saves the signature to a Base64 string.
+     * @group Methods
+     */
+    save: (format?: 'png' | 'jpeg' | 'svg') => Promise<string>;
+    /**
+     * Loads a signature from a JSON string of points or Base64 (if supported).
+     * Currently supports loading array of Point arrays.
+     * @group Methods
+     */
+    load: (data: number[][][] | string) => void;
+    /**
+     * Checks if signature is empty.
+     * @group Methods
+     */
+    isEmpty: () => boolean;
+    /**
+     * Returns the geometric data of the signature.
+     * @group Methods
+     */
+    getSignature: () => number[][][];
+}

package/dist/components/EzSignature/index.d.ts

@@ -0,0 +1,2 @@
+export { default as EzSignature } from './EzSignature';
+export * from './EzSignature.types';

package/dist/components/EzTable/EzColumnMenu.d.ts

@@ -0,0 +1,7 @@
+import { Column, Table } from '@tanstack/react-table';
+interface EzColumnMenuProps<TData, TValue> {
+    column: Column<TData, TValue>;
+    table: Table<TData>;
+}
+export declare function EzColumnMenu<TData, TValue>({ column, table }: EzColumnMenuProps<TData, TValue>): import("react").JSX.Element;
+export {};

package/dist/components/EzTable/EzDateFilterTree.d.ts

@@ -0,0 +1,7 @@
+interface EzDateFilterTreeProps {
+    uniqueValues: Map<any, number>;
+    selectedValues: Set<any> | null;
+    onBulkSelect: (values: any[], checked: boolean) => void;
+}
+export declare function EzDateFilterTree({ uniqueValues, selectedValues, onBulkSelect }: EzDateFilterTreeProps): import("react").JSX.Element;
+export {};

package/dist/components/EzTable/EzExcelFilter.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { Column, Table } from '@tanstack/react-table';
+interface EzExcelFilterProps<TData, TValue> {
+    column: Column<TData, TValue>;
+    table: Table<TData>;
+}
+export declare function EzExcelFilter<TData, TValue>({ column, table }: EzExcelFilterProps<TData, TValue>): React.JSX.Element;
+export {};

package/dist/components/EzTable/EzFilterBuilder.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { FilterGroup } from './EzTable.types';
+import { ColumnDef } from '@tanstack/react-table';
+interface EzFilterBuilderProps {
+    filter: FilterGroup;
+    columns: ColumnDef<any>[];
+    onChange: (filter: FilterGroup) => void;
+    depth?: number;
+    onRemove?: () => void;
+}
+export declare const EzFilterBuilder: React.FC<EzFilterBuilderProps>;
+export {};

package/dist/components/EzTable/EzGroupingPanel.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { GroupingState, Column } from '@tanstack/react-table';
+interface EzGroupingPanelProps {
+    grouping: GroupingState;
+    onGroupingChange: (grouping: GroupingState) => void;
+    columns: Column<any, any>[];
+}
+export declare const EzGroupingPanel: React.FC<EzGroupingPanelProps>;
+export {};

package/dist/components/EzTable/EzHeaderContextMenu.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { Header } from '@tanstack/react-table';
+interface EzHeaderContextMenuProps {
+    header: Header<any, any>;
+    children: React.ReactNode;
+}
+export declare function EzHeaderContextMenu({ header, children }: EzHeaderContextMenuProps): React.JSX.Element;
+export {};

package/dist/components/EzTable/EzPagination.d.ts

@@ -0,0 +1,19 @@
+import { EzTableLocalization } from './EzTable.types';
+interface PaginationProps {
+    pageIndex: number;
+    pageSize: number;
+    pageCount: number;
+    totalRows: number;
+    onPageChange: (page: number) => void;
+    onPageSizeChange: (size: number) => void;
+    canPreviousPage: boolean;
+    canNextPage: boolean;
+    localization?: EzTableLocalization;
+    changes?: {
+        added: number;
+        edited: number;
+        deleted: number;
+    };
+}
+export declare const EzPagination: React.FC<PaginationProps>;
+export {};

package/dist/components/EzTable/EzTable.types.d.ts

@@ -0,0 +1 @@
+export * from './types';

package/dist/components/EzTable/EzTableEditDialog.d.ts

@@ -0,0 +1,15 @@
+import { ColumnDef } from '@tanstack/react-table';
+interface EzTableEditDialogProps<TData> {
+    open: boolean;
+    onClose: () => void;
+    onSave: (data: TData) => void;
+    columns: ColumnDef<TData, any>[];
+    initialData?: Partial<TData>;
+    isNew?: boolean;
+    onFormRender?: (args: {
+        form: any;
+        mode: 'Add' | 'Edit';
+    }) => void;
+}
+export declare const EzTableEditDialog: <TData extends object>({ open, onClose, onSave, columns, initialData, isNew, onFormRender }: EzTableEditDialogProps<TData>) => import("react").JSX.Element | null;
+export {};

package/dist/components/EzTable/EzTableFooter.d.ts

@@ -0,0 +1,10 @@
+interface EzTableFooterProps {
+    table: any;
+    columnVirtualizer: any;
+    density: string;
+}
+export declare const EzTableFooter: {
+    ({ table, columnVirtualizer, density }: EzTableFooterProps): import("react").JSX.Element | null;
+    displayName: string;
+};
+export {};

package/dist/components/EzTable/EzTableOverlays.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+import { EzTableSlots, EzTableLocalization } from './EzTable.types';
+interface EzTableOverlaysProps {
+    isLoading: boolean;
+    rowCount: number;
+    renderNoRowsOverlay?: () => React.ReactNode;
+    slots?: EzTableSlots;
+    localization?: EzTableLocalization;
+}
+export declare const EzTableOverlays: React.MemoExoticComponent<({ isLoading, rowCount, renderNoRowsOverlay, slots, localization }: EzTableOverlaysProps) => React.JSX.Element | null>;
+export {};

package/dist/components/EzTable/EzTableStatusBar.d.ts

@@ -0,0 +1,10 @@
+import { Table } from '@tanstack/react-table';
+interface EzTableStatusBarProps {
+    table: Table<any>;
+    selectionInfo?: string;
+    rowSelection?: any;
+}
+export declare const EzTableStatusBar: import('react').MemoExoticComponent<({ table, totalRows, selectionInfo, rowSelection }: EzTableStatusBarProps & {
+    totalRows?: number;
+}) => import("react").JSX.Element>;
+export {};