ezux 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+/** @group Core Components */
+export * from './components/EzLayout';
+/** @group Core Components */
+export { EzTable } from './components/EzTable';
+/** @group Core Components */
+export { EzScheduler } from './components/EzScheduler';
+/** @group Core Components */
+export { EzTreeView } from './components/EzTreeView';
+/** @group Core Components */
+export { EzKanban } from './components/EzKanban';
+/** @group Core Components */
+export { EzSignature } from './components/EzSignature';
+/** @group Core Components */
+export { SignInForm } from './components/EzLayout/Authentication/SignInForm';
+/** @group Services */
+export { TableService } from './components/EzTable/services/TableService';
+/** @group Services */
+export { SchedulerService } from './components/EzScheduler/services/SchedulerService';
+/** @group Services */
+export { TreeService } from './components/EzTreeView/services/TreeService';
+/** @group Services */
+export { KanbanService } from './components/EzKanban/services/KanbanService';
+/** @group Services */
+export { EzServiceRegistry, globalServiceRegistry } from './shared/services/ServiceRegistry';
+/** @group Services */
+export { LayoutService } from './shared/services/LayoutService';
+/** @group Services */
+export { I18nService } from './shared/services/I18nService';
+/** @group Services */
+export { ThemeService } from './shared/services/ThemeService';
+/** @group Services */
+export { NotificationService } from './shared/services/NotificationService';
+/** @group Interfaces */
+export type { EzTableProps, EzTableRef, ColumnDef, EzColumnMeta, FilterOperator, FilterRule, FilterGroup, EzTableCellProps, EzTableEditorProps, ITableService, TableParams } from './components/EzTable/EzTable.types';
+/** @group Interfaces */
+export type { EzSchedulerProps, SchedulerEvent, Resource, EzSchedulerComponents, EzSchedulerRef, ISchedulerService } from './components/EzScheduler/EzScheduler.types';
+/** @group Interfaces */
+export type { EzTreeViewProps, TreeNode, EzTreeViewComponents, EzTreeViewApi, ITreeService } from './components/EzTreeView/EzTreeView.types';
+/** @group Interfaces */
+export type { EzKanbanProps, KanbanBoard, KanbanColumn, KanbanCard, EzKanbanRef, CardAssignee, KanbanSwimlane, IKanbanService } from './components/EzKanban/EzKanban.types';
+/** @group Interfaces */
+export type { EzSignatureProps, EzSignatureRef } from './components/EzSignature/EzSignature.types';
+/** @group Interfaces */
+export type { EzLayoutProps, EzLayoutRef } from './components/EzLayout/EzLayout.types';
+/** @group Interfaces */
+export type { AnimatedTextProps } from './shared/components/AnimatedText';
+/** @group Types */
+export * from './shared/types/BaseProps';
+/** @group Methods */
+export { useI18n } from './shared/hooks/useI18n';
+/** @group Methods */
+export { cn } from './lib/utils';
+/** @group Methods */
+export { formatNumber, formatDate, formatCurrency, formatPercent, formatDateTime } from './shared/utils/formatUtils';
+/** @group Methods */
+export { convertToCSV } from './shared/utils/csvUtils';
+/** @group Core Components */
+export { EzResourceSidebar } from './components/EzScheduler/components/EzResourceSidebar';
+/** @group Core Components */
+export { StatusBadge } from './shared/components/StatusBadge';
+/** @group Core Components */
+export { AnimatedText } from './shared/components/AnimatedText';
+/** @group Core Components */
+export { NotificationPanel } from './shared/components/NotificationPanel';
+/** @group Core Components */
+export { EzNotificationDropdown } from './shared/components/EzNotificationDropdown';
+/** @group Core Components */
+export * from './components/EzTable/renderers';
+/** @group UI Components */
+export * from './components/ui';

package/dist/lib/perfect-freehand.d.ts

@@ -0,0 +1,221 @@
+/**
+ * Negate a vector.
+ * @param A
+ * @internal
+ */
+export declare function neg(A: number[]): number[];
+/**
+ * Add vectors.
+ * @param A
+ * @param B
+ * @internal
+ */
+export declare function add(A: number[], B: number[]): number[];
+/**
+ * Subtract vectors.
+ * @param A
+ * @param B
+ * @internal
+ */
+export declare function sub(A: number[], B: number[]): number[];
+/**
+ * Vector multiplication by scalar
+ * @param A
+ * @param n
+ * @internal
+ */
+export declare function mul(A: number[], n: number): number[];
+/**
+ * Vector division by scalar.
+ * @param A
+ * @param n
+ * @internal
+ */
+export declare function div(A: number[], n: number): number[];
+/**
+ * Perpendicular rotation of a vector A
+ * @param A
+ * @internal
+ */
+export declare function per(A: number[]): number[];
+/**
+ * Dot product
+ * @param A
+ * @param B
+ * @internal
+ */
+export declare function dpr(A: number[], B: number[]): number;
+/**
+ * Get whether two vectors are equal.
+ * @param A
+ * @param B
+ * @internal
+ */
+export declare function isEqual(A: number[], B: number[]): boolean;
+/**
+ * Length of the vector
+ * @param A
+ * @internal
+ */
+export declare function len(A: number[]): number;
+/**
+ * Length of the vector squared
+ * @param A
+ * @internal
+ */
+export declare function len2(A: number[]): number;
+/**
+ * Dist length from A to B squared.
+ * @param A
+ * @param B
+ * @internal
+ */
+export declare function dist2(A: number[], B: number[]): number;
+/**
+ * Get normalized / unit vector.
+ * @param A
+ * @internal
+ */
+export declare function uni(A: number[]): number[];
+/**
+ * Dist length from A to B
+ * @param A
+ * @param B
+ * @internal
+ */
+export declare function dist(A: number[], B: number[]): number;
+/**
+ * Mean between two vectors or mid vector between two vectors
+ * @param A
+ * @param B
+ * @internal
+ */
+export declare function med(A: number[], B: number[]): number[];
+/**
+ * Rotate a vector around another vector by r (radians)
+ * @param A vector
+ * @param C center
+ * @param r rotation in radians
+ * @internal
+ */
+export declare function rotAround(A: number[], C: number[], r: number): number[];
+/**
+ * Interpolate vector A to B with a scalar t
+ * @param A
+ * @param B
+ * @param t scalar
+ * @internal
+ */
+export declare function lrp(A: number[], B: number[], t: number): number[];
+/**
+ * Project a point A in the direction B by a scalar c
+ * @param A
+ * @param B
+ * @param c
+ * @internal
+ */
+export declare function prj(A: number[], B: number[], c: number): number[];
+/**
+ * Compute a radius based on the pressure.
+ * @param size
+ * @param thinning
+ * @param pressure
+ * @param easing
+ * @internal
+ */
+export declare function getStrokeRadius(size: number, thinning: number, pressure: number, easing?: (t: number) => number): number;
+/**
+ * The options object for `getStroke` or `getStrokePoints`.
+ * @param points An array of points (as `[x, y, pressure]` or `{x, y, pressure}`). Pressure is optional in both cases.
+ * @param options (optional) An object with options.
+ * @param options.size	The base size (diameter) of the stroke.
+ * @param options.thinning The effect of pressure on the stroke's size.
+ * @param options.smoothing	How much to soften the stroke's edges.
+ * @param options.easing	An easing function to apply to each point's pressure.
+ * @param options.simulatePressure Whether to simulate pressure based on velocity.
+ * @param options.start Cap, taper and easing for the start of the line.
+ * @param options.end Cap, taper and easing for the end of the line.
+ * @param options.last Whether to handle the points as a completed stroke.
+ */
+export interface StrokeOptions {
+    size?: number;
+    thinning?: number;
+    smoothing?: number;
+    streamline?: number;
+    easing?: (pressure: number) => number;
+    simulatePressure?: boolean;
+    start?: {
+        cap?: boolean;
+        taper?: number | boolean;
+        easing?: (distance: number) => number;
+    };
+    end?: {
+        cap?: boolean;
+        taper?: number | boolean;
+        easing?: (distance: number) => number;
+    };
+    last?: boolean;
+}
+/**
+ * The points returned by `getStrokePoints`, and the input for `getStrokeOutlinePoints`.
+ */
+export interface StrokePoint {
+    point: number[];
+    pressure: number;
+    distance: number;
+    vector: number[];
+    runningLength: number;
+}
+/**
+ * ## getStrokePoints
+ * @description Get an array of points as objects with an adjusted point, pressure, vector, distance, and runningLength.
+ * @param points An array of points (as `[x, y, pressure]` or `{x, y, pressure}`). Pressure is optional in both cases.
+ * @param options (optional) An object with options.
+ * @param options.size	The base size (diameter) of the stroke.
+ * @param options.thinning The effect of pressure on the stroke's size.
+ * @param options.smoothing	How much to soften the stroke's edges.
+ * @param options.easing	An easing function to apply to each point's pressure.
+ * @param options.simulatePressure Whether to simulate pressure based on velocity.
+ * @param options.start Cap, taper and easing for the start of the line.
+ * @param options.end Cap, taper and easing for the end of the line.
+ * @param options.last Whether to handle the points as a completed stroke.
+ */
+export declare function getStrokePoints<T extends number[], K extends {
+    x: number;
+    y: number;
+    pressure?: number;
+}>(points: (T | K)[], options?: StrokeOptions): StrokePoint[];
+/**
+ * ## getStrokeOutlinePoints
+ * @description Get an array of points (as `[x, y]`) representing the outline of a stroke.
+ * @param points An array of StrokePoints as returned from `getStrokePoints`.
+ * @param options (optional) An object with options.
+ * @param options.size	The base size (diameter) of the stroke.
+ * @param options.thinning The effect of pressure on the stroke's size.
+ * @param options.smoothing	How much to soften the stroke's edges.
+ * @param options.easing	An easing function to apply to each point's pressure.
+ * @param options.simulatePressure Whether to simulate pressure based on velocity.
+ * @param options.start Cap, taper and easing for the start of the line.
+ * @param options.end Cap, taper and easing for the end of the line.
+ * @param options.last Whether to handle the points as a completed stroke.
+ */
+export declare function getStrokeOutlinePoints(points: StrokePoint[], options?: Partial<StrokeOptions>): number[][];
+/**
+ * ## getStroke
+ * @description Get an array of points describing a polygon that surrounds the input points.
+ * @param points An array of points (as `[x, y, pressure]` or `{x, y, pressure}`). Pressure is optional in both cases.
+ * @param options (optional) An object with options.
+ * @param options.size	The base size (diameter) of the stroke.
+ * @param options.thinning The effect of pressure on the stroke's size.
+ * @param options.smoothing	How much to soften the stroke's edges.
+ * @param options.easing	An easing function to apply to each point's pressure.
+ * @param options.simulatePressure Whether to simulate pressure based on velocity.
+ * @param options.start Cap, taper and easing for the start of the line.
+ * @param options.end Cap, taper and easing for the end of the line.
+ * @param options.last Whether to handle the points as a completed stroke.
+ */
+export declare function getStroke(points: (number[] | {
+    x: number;
+    y: number;
+    pressure?: number;
+})[], options?: StrokeOptions): number[][];

package/dist/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/shared/components/AnimatedText.d.ts

@@ -0,0 +1,44 @@
+import { default as React } from 'react';
+export interface AnimatedTextProps {
+    /**
+     * The text content to animate.
+     * @group Properties
+     */
+    text: string;
+    /**
+     * Custom class names for styling.
+     * @group Properties
+     */
+    className?: string;
+    /**
+     * Default text color.
+     * @group Properties
+     */
+    defaultColor?: string;
+    /**
+     * Text to highlight (will use primary color and wobble effect).
+     * @group Properties
+     */
+    highlight?: string;
+    /**
+     * Animation delay.
+     * @group Properties
+     */
+    delay?: string;
+    /**
+     * Custom text size class (overrides default).
+     * @group Properties
+     */
+    textSize?: string;
+    /**
+     * Direction for the main text.
+     * @group Properties
+     */
+    textDir?: "ltr" | "rtl";
+    /**
+     * Direction for the highlight text.
+     * @group Properties
+     */
+    highlightDir?: "ltr" | "rtl";
+}
+export declare const AnimatedText: React.FC<AnimatedTextProps>;

package/dist/shared/components/BaseCell.d.ts

@@ -0,0 +1,14 @@
+import { default as React } from 'react';
+export interface BaseCellProps {
+    value: any;
+    className?: string;
+    title?: string;
+    children?: React.ReactNode;
+    fallback?: React.ReactNode;
+    align?: 'left' | 'center' | 'right';
+}
+/**
+ * BaseCell - Shared logic for all table cells
+ * Handles null/undefined states, core typography, alignment, and tooltips.
+ */
+export declare const BaseCell: React.FC<BaseCellProps>;

package/dist/shared/components/BooleanRenderer.d.ts

@@ -0,0 +1,34 @@
+import { default as React } from 'react';
+export interface BooleanCellProps {
+    value: boolean | null | undefined;
+    trueLabel?: string;
+    falseLabel?: string;
+    nullLabel?: string;
+    showIcon?: boolean;
+    showLabel?: boolean;
+    variant?: 'checkbox' | 'switch';
+    className?: string;
+    disabled?: boolean;
+    onChange?: (value: boolean) => void;
+}
+export declare const BooleanCell: React.FC<BooleanCellProps>;
+export interface BooleanEditorProps {
+    value: boolean | null | undefined;
+    onChange: (value: boolean) => void;
+    trueLabel?: string;
+    falseLabel?: string;
+    variant?: 'checkbox' | 'switch';
+    disabled?: boolean;
+    className?: string;
+}
+export declare const BooleanEditor: React.FC<BooleanEditorProps>;
+export interface BooleanFilterProps {
+    value: 'all' | 'true' | 'false' | 'null';
+    onChange: (value: 'all' | 'true' | 'false' | 'null') => void;
+    trueLabel?: string;
+    falseLabel?: string;
+    nullLabel?: string;
+    allLabel?: string;
+    className?: string;
+}
+export declare const BooleanFilter: React.FC<BooleanFilterProps>;

package/dist/shared/components/ChartRenderer.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+export interface ProgressCellProps {
+    value: number;
+    showLabel?: boolean;
+    color?: 'default' | 'success' | 'warning' | 'danger' | 'info';
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+}
+export declare const ProgressCell: React.FC<ProgressCellProps>;
+export interface SparklineCellProps {
+    value?: number[];
+    values?: number[];
+    color?: 'default' | 'success' | 'warning' | 'danger' | 'info';
+    height?: number;
+    width?: number;
+    showDots?: boolean;
+    className?: string;
+}
+export declare const SparklineCell: React.FC<SparklineCellProps>;

package/dist/shared/components/DeleteConfirmationModal.d.ts

@@ -0,0 +1,11 @@
+import { default as React } from 'react';
+interface DeleteConfirmationModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    onConfirm: () => void;
+    title?: string;
+    message?: string;
+    description?: string;
+}
+export declare const DeleteConfirmationModal: React.FC<DeleteConfirmationModalProps>;
+export {};

package/dist/shared/components/EzContextMenu.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+import { Row } from '@tanstack/react-table';
+interface EzContextMenuProps<TData> {
+    row?: Row<TData>;
+    data?: TData;
+    contextId?: string;
+    children: React.ReactNode;
+    enabled?: boolean;
+    onAction?: (action: string, data: TData) => void;
+}
+export declare const EzContextMenu: <TData>({ row, data, contextId, children, enabled, onAction }: EzContextMenuProps<TData>) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/shared/components/EzNotificationDropdown.d.ts

@@ -0,0 +1 @@
+export declare const EzNotificationDropdown: () => import("react/jsx-runtime").JSX.Element;

package/dist/shared/components/HighlightText.d.ts

@@ -0,0 +1,4 @@
+export declare const HighlightText: ({ text, highlight }: {
+    text: string | number | unknown;
+    highlight?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/shared/components/Modal.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+export interface ModalProps {
+    isOpen: boolean;
+    onClose: () => void;
+    title?: React.ReactNode;
+    children: React.ReactNode;
+    footer?: React.ReactNode;
+    className?: string;
+    size?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+    closeOnBackdropClick?: boolean;
+    showCloseButton?: boolean;
+}
+export declare const Modal: React.FC<ModalProps>;

package/dist/shared/components/NotificationPanel.d.ts

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export declare const NotificationPanel: React.FC;

package/dist/shared/components/PrimitiveRenderer.d.ts

@@ -0,0 +1,39 @@
+import { default as React } from 'react';
+export interface PrimitiveCellProps {
+    value: any;
+    columnType?: 'text' | 'number' | 'date' | 'datetime' | 'longtext';
+    meta?: any;
+    className?: string;
+    align?: 'left' | 'center' | 'right';
+    table?: any;
+}
+/**
+ * PrimitiveCell - Unified renderer for simple data types.
+ * Replaces TextCell, NumberCell, DateCell, etc.
+ */
+export declare const PrimitiveCell: React.FC<PrimitiveCellProps>;
+export interface PrimitiveEditorProps {
+    value: any;
+    onChange: (value: any) => void;
+    onBlur?: () => void;
+    columnType?: string;
+    autoFocus?: boolean;
+    isFocused?: boolean;
+    className?: string;
+    placeholder?: string;
+    meta?: any;
+}
+/**
+ * PrimitiveEditor - Unified editor for simple inputs.
+ * Replaces TextEditor, NumberEditor, etc.
+ */
+export declare const PrimitiveEditor: React.FC<PrimitiveEditorProps>;
+export type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'doesNotContain' | 'startsWith' | 'endsWith' | 'gt' | 'gte' | 'lt' | 'lte' | 'between';
+export interface PrimitiveFilterProps {
+    columnType: 'text' | 'number' | 'date' | 'datetime' | 'longtext' | string;
+    value: any;
+    valueTo?: any;
+    operator: FilterOperator;
+    onChange: (value: any, operator: FilterOperator, valueTo?: any) => void;
+}
+export declare const PrimitiveFilter: React.FC<PrimitiveFilterProps>;

package/dist/shared/components/SearchableSelect.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+export interface SearchableSelectProps {
+    value?: string | null;
+    onChange: (value: string) => void;
+    options: {
+        value: string;
+        label: string;
+    }[];
+    placeholder?: string;
+    className?: string;
+    onBlur?: () => void;
+}
+export declare const SearchableSelect: React.FC<SearchableSelectProps>;

package/dist/shared/components/SelectRenderer.d.ts

@@ -0,0 +1,33 @@
+import { default as React } from 'react';
+export interface SelectOption {
+    value: string;
+    label: string;
+    color?: 'default' | 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info';
+}
+export interface SelectCellProps {
+    value: string | string[] | null | undefined;
+    options?: SelectOption[];
+    multiSelect?: boolean;
+    className?: string;
+    table?: any;
+}
+export declare const SelectCell: React.FC<SelectCellProps>;
+export interface SelectEditorProps {
+    value: any;
+    onChange: (value: any) => void;
+    options: SelectOption[];
+    variant?: 'dropdown' | 'radio' | 'combobox';
+    multiSelect?: boolean;
+    onBlur?: () => void;
+    className?: string;
+    placeholder?: string;
+    isFocused?: boolean;
+}
+export declare const SelectEditor: React.FC<SelectEditorProps>;
+export interface SelectFilterProps {
+    options: SelectOption[];
+    selectedValues: string[];
+    onChange: (values: string[]) => void;
+    className?: string;
+}
+export declare const SelectFilter: React.FC<SelectFilterProps>;

package/dist/shared/components/StatusBadge.d.ts

@@ -0,0 +1,12 @@
+export type Status = 'Active' | 'Inactive' | 'Pending' | 'Verified' | 'Unverified' | 'On Leave' | 'Completed' | 'In Progress';
+interface StatusBadgeProps {
+    status: Status | string;
+    className?: string;
+}
+/**
+ * Optimized StatusBadge component
+ * - Dot indicator for better visual recognition
+ * - High-contrast styling for maximum visibility
+ */
+export declare const StatusBadge: import('react').NamedExoticComponent<StatusBadgeProps>;
+export {};

package/dist/shared/components/TooltipWrapper.d.ts

@@ -0,0 +1,12 @@
+import { default as React } from 'react';
+interface TooltipWrapperProps {
+    children: React.ReactNode;
+    content?: React.ReactNode;
+    enabled?: boolean;
+    delayDuration?: number;
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    align?: 'start' | 'center' | 'end';
+    className?: string;
+}
+export declare const TooltipWrapper: React.FC<TooltipWrapperProps>;
+export {};

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

@@ -0,0 +1,9 @@
+export * from './AnimatedText';
+export * from './StatusBadge';
+export * from './BaseCell';
+export * from './PrimitiveRenderer';
+export * from './BooleanRenderer';
+export * from './SelectRenderer';
+export * from './ChartRenderer';
+export * from './HighlightText';
+export * from './SearchableSelect';

package/dist/shared/hooks/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared hooks index
+ * Exports all shared hooks for easy importing
+ */
+export { useBaseComponent } from './useBaseComponent';
+export type { BaseComponentConfig, BaseComponentState, BaseComponentAPI } from './useBaseComponent';
+export { useVirtualization } from './useVirtualization';
+export type { VirtualizationConfig, VirtualizationResult } from './useVirtualization';
+export { useEzTheme } from './useEzTheme';
+export { useI18n } from './useI18n';
+export { useLifecycleEvents } from './useLifecycleEvents';
+export type { LifecycleCallbacks } from './useLifecycleEvents';
+export { useDataChangeEvents } from './useDataChangeEvents';
+export type { DataChangeCallbacks } from './useDataChangeEvents';
+export { useRowSelectionEvents } from './useRowSelectionEvents';
+export type { RowSelectionCallbacks, RowSelectionState } from './useRowSelectionEvents';
+export { useStateChangeEvents } from './useStateChangeEvents';
+export type { StateChangeCallbacks, SortingState, PaginationState } from './useStateChangeEvents';
+export { useComponentState } from './useComponentState';
+export type { StateConfig } from './useComponentState';
+export { useEventHandlers } from './useEventHandlers';
+export type { EventHandlerConfig } from './useEventHandlers';
+/**
+ * An advanced hook for exposing an imperative API from an EzUX component.
+ *
+ * Standardizes the pattern of using `useImperativeHandle` with optional validation
+ * methods and base API merging.
+ *
+ * @param ref The ref object to attach the API to.
+ * @param api The core API methods to expose.
+ * @param options Additional imperative methods or overrides.
+ * @group Hooks
+ */
+export { useComponentImperativeAPI } from './useComponentImperativeAPI';
+/**
+ * A lightweight hook for exposing an imperative API from a component.
+ *
+ * Consolidates the imperative API pattern using `useImperativeHandle`,
+ * ensuring efficient reference stability.
+ *
+ * @param ref The ref object from the forwardRef or parent component.
+ * @param api An object containing the methods and properties to expose.
+ * @group Hooks
+ */
+export { useImperativeAPI } from './useImperativeAPI';
+export { useDndHandlers } from './useDndHandlers';
+export { useLoadingState } from './useLoadingState';
+export { useFieldValidation } from './useFieldValidation';
+export { useService } from './useService';
+export { useMediaQuery } from './useMediaQuery';
+export { useCurrentTime } from './useCurrentTime';
+export { useDialogState } from './useDialogState';
+export { useKeyboardNavigation } from './useKeyboardNavigation';
+export { useHistory } from './useHistory';
+export { useServiceState } from './useServiceState';
+export { useInitCoreServices } from './useInitCoreServices';