ezux 1.1.13 → 1.1.18

package/dist/scheduler.es.js

@@ -1,11 +1,2 @@
-import "react/jsx-runtime";
-import "react";
-import "./useInitCoreServices-D1WaWlaI.js";
-import { E as c } from "./index-C6NfgycP.js";
-import "./EzErrorBoundary-D4NBadES.js";
-import "./EzContextMenu-BSA_B6Pr.js";
-import "./tooltip-BCtrEe0z.js";
-import "./TooltipWrapper-BrRTi5EJ.js";
-export {
-  c as EzScheduler
-};
+import { t as e } from "./EzScheduler-C1Jtvvju.js";
+export { e as EzScheduler };

package/dist/scroll-area-BJs87d45.js

@@ -0,0 +1,35 @@
+import { _ as e } from "./EzProvider-AlmsYIDk.js";
+import "react";
+import { jsx as t, jsxs as n } from "react/jsx-runtime";
+import * as r from "@radix-ui/react-scroll-area";
+//#region src/components/ui/scroll-area.tsx
+function i({ className: i, children: o, ...s }) {
+	return /* @__PURE__ */ n(r.Root, {
+		"data-slot": "scroll-area",
+		className: e("relative", i),
+		...s,
+		children: [
+			/* @__PURE__ */ t(r.Viewport, {
+				"data-slot": "scroll-area-viewport",
+				className: "focus-visible:ring-ring/50 size-full rounded-[inherit] transition-[color,box-shadow] outline-none focus-visible:ring-[3px] focus-visible:outline-1",
+				children: o
+			}),
+			/* @__PURE__ */ t(a, {}),
+			/* @__PURE__ */ t(r.Corner, {})
+		]
+	});
+}
+function a({ className: n, orientation: i = "vertical", ...a }) {
+	return /* @__PURE__ */ t(r.Scrollbar, {
+		"data-slot": "scroll-area-scrollbar",
+		orientation: i,
+		className: e("flex touch-none p-px transition-colors select-none", i === "vertical" && "h-full w-2.5 border-l border-l-transparent", i === "horizontal" && "h-2.5 flex-col border-t border-t-transparent", n),
+		...a,
+		children: /* @__PURE__ */ t(r.Thumb, {
+			"data-slot": "scroll-area-thumb",
+			className: "bg-border relative flex-1 rounded-full"
+		})
+	});
+}
+//#endregion
+export { a as n, i as t };

package/dist/scroll-area-DSkE2KB_.cjs

@@ -0,0 +1 @@
+const e=require("./EzProvider-L2qQMq-v.cjs");let t=require("react");t=e.y(t,1);let n=require("react/jsx-runtime"),r=require("@radix-ui/react-scroll-area");r=e.y(r,1);function i({className:t,children:i,...o}){return(0,n.jsxs)(r.Root,{"data-slot":`scroll-area`,className:e._(`relative`,t),...o,children:[(0,n.jsx)(r.Viewport,{"data-slot":`scroll-area-viewport`,className:`focus-visible:ring-ring/50 size-full rounded-[inherit] transition-[color,box-shadow] outline-none focus-visible:ring-[3px] focus-visible:outline-1`,children:i}),(0,n.jsx)(a,{}),(0,n.jsx)(r.Corner,{})]})}function a({className:t,orientation:i=`vertical`,...a}){return(0,n.jsx)(r.Scrollbar,{"data-slot":`scroll-area-scrollbar`,orientation:i,className:e._(`flex touch-none p-px transition-colors select-none`,i===`vertical`&&`h-full w-2.5 border-l border-l-transparent`,i===`horizontal`&&`h-2.5 flex-col border-t border-t-transparent`,t),...a,children:(0,n.jsx)(r.Thumb,{"data-slot":`scroll-area-thumb`,className:`bg-border relative flex-1 rounded-full`})})}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return i}});

package/dist/select-D4tFaSai.js

@@ -0,0 +1,43 @@
+import { _ as e } from "./EzProvider-AlmsYIDk.js";
+import { a as t, h as n, r, t as i } from "./dropdown-menu-B_7_K13o.js";
+import * as a from "react";
+import { jsx as o } from "react/jsx-runtime";
+//#region src/components/ui/select.tsx
+var s = a.createContext(null), c = ({ value: e, onValueChange: t, children: n, open: r, onOpenChange: c }) => {
+	let [l, u] = a.useState(!1), d = r === void 0 ? l : r, f = c || u;
+	return /* @__PURE__ */ o(s.Provider, {
+		value: {
+			value: e,
+			onValueChange: t,
+			setOpen: f
+		},
+		children: /* @__PURE__ */ o(i, {
+			open: d,
+			onOpenChange: f,
+			children: n
+		})
+	});
+}, l = ({ className: t, children: r }) => /* @__PURE__ */ o(n, {
+	asChild: !0,
+	children: /* @__PURE__ */ o("button", {
+		className: e("flex h-9 w-full items-center justify-between rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-sm ring-offset-background placeholder:text-muted-foreground focus:outline-none focus:ring-1 focus:ring-ring disabled:cursor-not-allowed disabled:opacity-50", t),
+		children: r
+	})
+}), u = ({ placeholder: e, children: t }) => {
+	let n = a.useContext(s);
+	return /* @__PURE__ */ o("span", { children: t || n?.value || e });
+}, d = ({ children: t, className: n }) => /* @__PURE__ */ o(r, {
+	className: e("max-h-[200px] overflow-y-auto", n),
+	children: t
+}), f = ({ value: n, children: r }) => {
+	let i = a.useContext(s);
+	return /* @__PURE__ */ o(t, {
+		className: e("flex cursor-default select-none items-center rounded-sm px-2 py-1.5 text-sm outline-none focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 text-start", i?.value === n && "font-bold"),
+		onSelect: () => {
+			i?.onValueChange?.(n), i?.setOpen(!1);
+		},
+		children: r
+	});
+};
+//#endregion
+export { u as a, l as i, d as n, f as r, c as t };

package/dist/select-sVieKbLu.cjs

@@ -0,0 +1 @@
+const e=require("./EzProvider-L2qQMq-v.cjs"),t=require("./dropdown-menu-BRP0tyR_.cjs");let n=require("react");n=e.y(n,1);let r=require("react/jsx-runtime");var i=n.createContext(null),a=({value:e,onValueChange:a,children:o,open:s,onOpenChange:c})=>{let[l,u]=n.useState(!1),d=s===void 0?l:s,f=c||u;return(0,r.jsx)(i.Provider,{value:{value:e,onValueChange:a,setOpen:f},children:(0,r.jsx)(t.t,{open:d,onOpenChange:f,children:o})})},o=({className:n,children:i})=>(0,r.jsx)(t.h,{asChild:!0,children:(0,r.jsx)(`button`,{className:e._(`flex h-9 w-full items-center justify-between rounded-md border border-input bg-transparent px-3 py-2 text-sm shadow-sm ring-offset-background placeholder:text-muted-foreground focus:outline-none focus:ring-1 focus:ring-ring disabled:cursor-not-allowed disabled:opacity-50`,n),children:i})}),s=({placeholder:e,children:t})=>{let a=n.useContext(i);return(0,r.jsx)(`span`,{children:t||a?.value||e})},c=({children:n,className:i})=>(0,r.jsx)(t.r,{className:e._(`max-h-[200px] overflow-y-auto`,i),children:n}),l=({value:a,children:o})=>{let s=n.useContext(i);return(0,r.jsx)(t.a,{className:e._(`flex cursor-default select-none items-center rounded-sm px-2 py-1.5 text-sm outline-none focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 text-start`,s?.value===a&&`font-bold`),onSelect:()=>{s?.onValueChange?.(a),s?.setOpen(!1)},children:o})};Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return a}});

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>) => React.JSX.Element;
+export {};

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

@@ -0,0 +1,2 @@
+import { default as React } from 'react';
+export declare const EzNotificationDropdown: () => React.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.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,21 @@
+export type Status = 'Active' | 'Inactive' | 'Pending' | 'Verified' | 'Unverified' | 'On Leave' | 'Completed' | 'In Progress' | 'Archived' | 'Under Review' | 'Approved' | 'Rejected' | 'Draft' | 'Published' | 'Expired' | 'Scheduled' | 'Cancelled' | 'Resolved' | 'Unresolved' | 'Open' | 'Closed' | 'Default' | 'Disapproved' | 'Returned' | 'Public' | 'Private' | 'Restricted' | 'Internal' | 'External' | 'System';
+export interface StatusBadgeProps {
+    status: Status | string;
+    className?: string;
+    showDot?: boolean;
+    showIcon?: boolean;
+    iconPosition?: 'left' | 'right';
+    hideLabel?: boolean;
+    showTooltip?: boolean;
+    variant?: 'solid' | 'outline';
+    customWidth?: string;
+    customHeight?: string;
+    customFontSize?: string;
+    customBgColor?: string;
+    customTextColor?: string;
+    showBorder?: boolean;
+    borderThickness?: string;
+    customBorderColor?: string;
+    glowIntensity?: 'none' | 'low' | 'medium' | 'high';
+}
+export declare const StatusBadge: import('react').NamedExoticComponent<StatusBadgeProps>;

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/contexts/EzProvider.d.ts

@@ -0,0 +1,56 @@
+import { default as React } from 'react';
+import { ServiceRegistry } from '../services/ServiceRegistry';
+import { ThemeService } from '../services/ThemeService';
+import { I18nService } from '../services/I18nService';
+import { NotificationService } from '../services/NotificationService';
+import { LayoutService } from '../services/LayoutService';
+export interface EzProviderProps {
+    children: React.ReactNode;
+    /**
+     * Optional default locale to initialize the I18nService.
+     */
+    defaultLocale?: string;
+    /**
+     * Optional custom translations to merge on initialization.
+     */
+    translations?: Record<string, Record<string, string>>;
+}
+/**
+ * `<EzProvider>` serves as the central orchestration point for all EzUX global services.
+ * It initializes a localized `ServiceRegistry`, instantiates core services, and
+ * provides them to child components via React Context safely resolving SSR problems.
+ *
+ * @group Core Components
+ */
+export declare const EzProvider: React.FC<EzProviderProps>;
+/**
+ * Hook to access the current `ServiceRegistry`.
+ * Throws if called outside of `<EzProvider>`.
+ *
+ * @group Hooks
+ */
+export declare const useEzServiceRegistry: () => ServiceRegistry;
+/**
+ * Access the application-wide `ThemeService`.
+ *
+ * @group Hooks
+ */
+export declare const useThemeService: () => ThemeService;
+/**
+ * Access the application-wide `I18nService`.
+ *
+ * @group Hooks
+ */
+export declare const useI18nService: () => I18nService;
+/**
+ * Access the application-wide `NotificationService`.
+ *
+ * @group Hooks
+ */
+export declare const useNotificationService: () => NotificationService;
+/**
+ * Access the application-wide `LayoutService`.
+ *
+ * @group Hooks
+ */
+export declare const useLayoutService: () => LayoutService;

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';

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

@@ -0,0 +1,59 @@
+import { ServiceRegistry } from '../services/ServiceRegistry';
+import { ComponentEventCallbacks } from '../types/common';
+/**
+ * Common properties for all core components.
+ * @group Properties
+ */
+export interface BaseComponentProps extends ComponentEventCallbacks {
+    /**
+     * The shared service registry instance.
+     * @group Services
+     */
+    serviceRegistry?: ServiceRegistry;
+}
+export type BaseComponentConfig = BaseComponentProps;
+/**
+ * Base internal state for core components.
+ * @group State
+ */
+export interface BaseComponentState {
+    /** Whether the component is processing an async action. @group State */
+    isLoading: boolean;
+    /** Current error state. @group State */
+    error: Error | null;
+    /** Whether the component has mounted on the client. @group State */
+    isHydrated: boolean;
+}
+/**
+ * Foundation API shared by all core components.
+ * @group Methods
+ */
+export interface BaseComponentAPI {
+    /** Shows the global component spinner. @group Methods */
+    showSpinner: () => void;
+    /** Hides the global component spinner. @group Methods */
+    hideSpinner: () => void;
+}
+/**
+ * A foundational hook that provides shared infrastructure for all core components.
+ *
+ * Handles service registry resolution, basic lifecycle events, and common loading/error state.
+ *
+ * @param props The component's props.
+ * @group Hooks
+ */
+export declare const useBaseComponent: (props: BaseComponentProps) => {
+    /** The resolved service registry for this component. @group Services */
+    serviceRegistry: ServiceRegistry;
+    /** Current base state (loading, error, hydrated). @group State */
+    state: BaseComponentState;
+    /** Functional setter for loading state. @group Methods */
+    setIsLoading: (isLoading: boolean) => void;
+    /** Functional setter for error state. @group Methods */
+    setError: (error: Error | null) => void;
+    /** Base API (spinner controls). @group Methods */
+    api: {
+        showSpinner: () => void;
+        hideSpinner: () => void;
+    };
+};

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

@@ -0,0 +1,11 @@
+import { Ref } from 'react';
+export interface ImperativeAPIOptions {
+    validateField?: (data: any) => boolean;
+    validateEditForm?: () => boolean;
+    [key: string]: any;
+}
+/**
+ * Generic imperative API hook for all EzUX components
+ * Standardizes imperative API pattern across components
+ */
+export declare const useComponentImperativeAPI: <T extends Record<string, any>>(ref: Ref<T> | undefined, api: T, options?: ImperativeAPIOptions) => void;

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

@@ -0,0 +1,39 @@
+import { IService } from '../services/ServiceRegistry';
+/**
+ * Configuration for the useComponentState hook.
+ * @group Properties
+ */
+export interface StateConfig<T> {
+    /** Initial state value. @group Data */
+    initialState: T;
+    /** Optional service for state synchronization. @group Services */
+    service?: IService;
+    /** LocalStorage key for state persistence. @group Properties */
+    persistenceKey?: string;
+    /** Delay in milliseconds for state update debouncing. @group Properties */
+    debounceMs?: number;
+    /** Callback triggered when state changes. @group Events */
+    onChange?: (state: T) => void;
+}
+/**
+ * A robust state management hook with support for debouncing, persistence, and service integration.
+ *
+ * @param config Configuration for the state management.
+ * @group Hooks
+ */
+export declare function useComponentState<T>(config: StateConfig<T>): {
+    /** The current state object. @group State */
+    state: T;
+    /** Updates the state (with optional debouncing). @group Methods */
+    setState: (updater: T | ((prev: T) => T)) => void;
+    /** Updates the state immediately, bypassing debouncing. @group Methods */
+    setImmediateState: (newState: T) => void;
+    /** Whether a state-related async operation is in progress. @group State */
+    loading: boolean;
+    /** Functional setter for loading state. @group Methods */
+    setLoading: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+    /** Current error state. @group State */
+    error: Error | null;
+    /** Functional setter for error state. @group Methods */
+    setError: import('react').Dispatch<import('react').SetStateAction<Error | null>>;
+};

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

@@ -0,0 +1,6 @@
+/**
+ * Shared hook for centralized timekeeping.
+ * Updates every minute and provides a stable Date object.
+ * Useful for "Current Time" indicators in calendars/schedulers.
+ */
+export declare function useCurrentTime(refreshInterval?: number): Date;