alepha 0.10.7 → 0.11.1

package/ui.d.ts

@@ -2,26 +2,61 @@ import * as _alepha_core0 from "alepha";
 import { TObject } from "alepha";
 import * as _alepha_react0 from "alepha/react";
 import { RouterGoOptions, UseActiveOptions } from "alepha/react";
+import { ModalsProviderProps } from "@mantine/modals";
+import { AutocompleteProps, ButtonProps, ColorInputProps, ColorSchemeScriptProps, FileInputProps, Flex, MantineProviderProps, ModalProps, MultiSelectProps, NumberInputProps, PasswordInputProps, SegmentedControlProps, SelectProps, SwitchProps, TableProps, TagsInputProps, TextInputProps, TextareaProps, TooltipProps } from "@mantine/core";
+import * as react_jsx_runtime6 from "react/jsx-runtime";
+import React$1, { ComponentType, FC, ReactNode } from "react";
 import * as _mantine_notifications0 from "@mantine/notifications";
 import { NotificationData, NotificationsProps } from "@mantine/notifications";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
-import { AutocompleteProps, ButtonProps, ColorInputProps, ColorSchemeScriptProps, FileInputProps, Flex, MantineProviderProps, MultiSelectProps, NumberInputProps, PasswordInputProps, SegmentedControlProps, SelectProps, SwitchProps, TagsInputProps, TextInputProps, TextareaProps } from "@mantine/core";
 import { FormModel, InputField } from "alepha/react/form";
-import { ComponentType, ReactNode } from "react";
-import { ModalsProviderProps } from "@mantine/modals";
 import { NavigationProgressProps } from "@mantine/nprogress";
 import { SpotlightActionData } from "@mantine/spotlight";
 import { DateInputProps, DateTimePickerProps, TimeInputProps } from "@mantine/dates";
 
+//#region src/utils/parseInput.d.ts
+interface GenericControlProps {
+  input: InputField;
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+}
+//#endregion
+//#region src/components/ControlSelect.d.ts
+type SelectValueLabel = string | {
+  value: string;
+  label: string;
+  icon?: string;
+};
+interface ControlSelectProps extends GenericControlProps {
+  select?: boolean | SelectProps;
+  multi?: boolean | MultiSelectProps;
+  tags?: boolean | TagsInputProps;
+  autocomplete?: boolean | AutocompleteProps;
+  segmented?: boolean | Partial<SegmentedControlProps>;
+  loader?: () => Promise<SelectValueLabel[]>;
+}
+/**
+ * ControlSelect component for handling Select, MultiSelect, and TagsInput.
+ *
+ * Features:
+ * - Basic Select with enum support
+ * - MultiSelect for array of enums
+ * - TagsInput for array of strings (no enum)
+ * - Future: Lazy loading
+ * - Future: Searchable/filterable options
+ * - Future: Custom option rendering
+ *
+ * Automatically detects enum values and array types from schema.
+ */
+declare const ControlSelect: (props: ControlSelectProps) => react_jsx_runtime6.JSX.Element | null;
+//#endregion
 //#region src/components/Control.d.ts
 interface ControlProps extends GenericControlProps {
   text?: TextInputProps;
   area?: boolean | TextareaProps;
-  select?: boolean | SelectProps;
-  autocomplete?: boolean | AutocompleteProps;
+  select?: boolean | Partial<ControlSelectProps>;
   password?: boolean | PasswordInputProps;
   switch?: boolean | SwitchProps;
-  segmented?: boolean | Partial<SegmentedControlProps>;
   number?: boolean | NumberInputProps;
   file?: boolean | FileInputProps;
   color?: boolean | ColorInputProps;
@@ -51,22 +86,69 @@ interface ControlProps extends GenericControlProps {
  *
  * Automatically handles labels, descriptions, error messages, required state, and default icons.
  */
-declare const Control: (props: ControlProps) => react_jsx_runtime0.JSX.Element | null;
-interface GenericControlProps {
-  input: InputField;
-  title?: string;
-  description?: string;
-  icon?: ReactNode;
-}
+declare const Control: (_props: ControlProps) => react_jsx_runtime6.JSX.Element | null;
 type CustomControlProps = {
   defaultValue: any;
   onChange: (value: any) => void;
 };
 //#endregion
 //#region src/components/Action.d.ts
+interface ActionMenuItem {
+  /**
+   * Menu item type
+   */
+  type?: "item" | "divider" | "label";
+  /**
+   * Label text for the menu item
+   */
+  label?: string;
+  /**
+   * Icon element to display before the label
+   */
+  icon?: ReactNode;
+  /**
+   * Click handler for menu items
+   */
+  onClick?: () => void;
+  /**
+   * Color for the menu item (e.g., "red" for danger actions)
+   */
+  color?: string;
+  /**
+   * Nested submenu items
+   */
+  children?: ActionMenuItem[];
+}
+interface ActionMenuConfig {
+  /**
+   * Array of menu items to display
+   */
+  items: ActionMenuItem[];
+  /**
+   * Menu position relative to the button
+   */
+  position?: "bottom" | "bottom-start" | "bottom-end" | "top" | "top-start" | "top-end" | "left" | "right";
+  /**
+   * Menu width
+   */
+  width?: number | string;
+  /**
+   * Menu shadow
+   */
+  shadow?: "xs" | "sm" | "md" | "lg" | "xl";
+}
 interface ActionCommonProps extends ButtonProps {
   children?: ReactNode;
   textVisibleFrom?: "xs" | "sm" | "md" | "lg" | "xl";
+  /**
+   * Tooltip to display on hover. Can be a string for simple tooltips
+   * or a TooltipProps object for advanced configuration.
+   */
+  tooltip?: string | TooltipProps;
+  /**
+   * Menu configuration. When provided, the action will display a dropdown menu.
+   */
+  menu?: ActionMenuConfig;
   /**
    * If set, a confirmation dialog will be shown before performing the action.
    * If `true`, a default title and message will be used.
@@ -79,7 +161,7 @@ interface ActionCommonProps extends ButtonProps {
   };
 }
 type ActionProps = ActionCommonProps & (ActiveHrefProps | ActionClickProps | ActionSubmitProps | {});
-declare const Action: (_props: ActionProps) => react_jsx_runtime0.JSX.Element;
+declare const Action: (_props: ActionProps) => react_jsx_runtime6.JSX.Element;
 interface ActionSubmitProps extends ButtonProps {
   form: FormModel<any>;
 }
@@ -99,7 +181,7 @@ interface OmnibarProps {
   searchPlaceholder?: string;
   nothingFound?: ReactNode;
 }
-declare const Omnibar: (props: OmnibarProps) => react_jsx_runtime0.JSX.Element;
+declare const Omnibar: (props: OmnibarProps) => react_jsx_runtime6.JSX.Element;
 //#endregion
 //#region src/components/AlephaMantineProvider.d.ts
 interface AlephaMantineProviderProps {
@@ -111,7 +193,7 @@ interface AlephaMantineProviderProps {
   modals?: ModalsProviderProps;
   omnibar?: OmnibarProps;
 }
-declare const AlephaMantineProvider: (props: AlephaMantineProviderProps) => react_jsx_runtime0.JSX.Element;
+declare const AlephaMantineProvider: (props: AlephaMantineProviderProps) => react_jsx_runtime6.JSX.Element;
 //#endregion
 //#region src/components/ControlDate.d.ts
 interface ControlDateProps extends GenericControlProps {
@@ -129,28 +211,7 @@ interface ControlDateProps extends GenericControlProps {
  *
  * Automatically detects date formats from schema and renders appropriate picker.
  */
-declare const ControlDate: (props: ControlDateProps) => react_jsx_runtime0.JSX.Element | null;
-//#endregion
-//#region src/components/ControlSelect.d.ts
-interface ControlSelectProps extends GenericControlProps {
-  select?: boolean | SelectProps;
-  multi?: boolean | MultiSelectProps;
-  tags?: boolean | TagsInputProps;
-}
-/**
- * ControlSelect component for handling Select, MultiSelect, and TagsInput.
- *
- * Features:
- * - Basic Select with enum support
- * - MultiSelect for array of enums
- * - TagsInput for array of strings (no enum)
- * - Future: Lazy loading
- * - Future: Searchable/filterable options
- * - Future: Custom option rendering
- *
- * Automatically detects enum values and array types from schema.
- */
-declare const ControlSelect: (props: ControlSelectProps) => react_jsx_runtime0.JSX.Element | null;
+declare const ControlDate: (props: ControlDateProps) => react_jsx_runtime6.JSX.Element | null;
 //#endregion
 //#region src/components/DarkModeButton.d.ts
 interface DarkModeButtonProps {
@@ -158,11 +219,256 @@ interface DarkModeButtonProps {
   size?: string | number;
   variant?: "filled" | "light" | "outline" | "default" | "subtle" | "transparent";
 }
-declare const DarkModeButton: (props: DarkModeButtonProps) => react_jsx_runtime0.JSX.Element;
+declare const DarkModeButton: (props: DarkModeButtonProps) => react_jsx_runtime6.JSX.Element;
+//#endregion
+//#region src/components/DataTable.d.ts
+type SortDirection = "asc" | "desc" | null;
+interface DataTableColumn<T = any> {
+  accessor: keyof T | string;
+  title?: string;
+  width?: number | string;
+  sortable?: boolean;
+  filterable?: boolean;
+  hidden?: boolean;
+  render?: (value: any, record: T, index: number) => React$1.ReactNode;
+  renderHeader?: () => React$1.ReactNode;
+  align?: "left" | "center" | "right";
+  ellipsis?: boolean;
+  className?: string;
+  headerClassName?: string;
+}
+interface DataTableSort {
+  column: string;
+  direction: SortDirection;
+}
+interface DataTableFilter {
+  column: string;
+  value: string;
+  operator?: "contains" | "equals" | "startsWith" | "endsWith";
+}
+interface DataTableProps<T = any> extends Omit<TableProps, "data"> {
+  data: T[];
+  columns: DataTableColumn<T>[];
+  loading?: boolean;
+  emptyMessage?: string;
+  selectable?: boolean;
+  selectedRows?: T[];
+  onRowSelect?: (rows: T[]) => void;
+  sortable?: boolean;
+  sort?: DataTableSort;
+  onSortChange?: (sort: DataTableSort) => void;
+  filterable?: boolean;
+  filters?: DataTableFilter[];
+  onFiltersChange?: (filters: DataTableFilter[]) => void;
+  filterPlaceholder?: string;
+  paginate?: boolean;
+  page?: number;
+  pageSize?: number;
+  totalRecords?: number;
+  pageSizeOptions?: number[];
+  onPageChange?: (page: number) => void;
+  onPageSizeChange?: (size: number) => void;
+  rowActions?: (record: T, index: number) => React$1.ReactNode;
+  onRowClick?: (record: T, index: number) => void;
+  rowClassName?: (record: T, index: number) => string;
+  showHeader?: boolean;
+  showFooter?: boolean;
+  stickyHeader?: boolean;
+  striped?: boolean;
+  highlightOnHover?: boolean;
+  showToolbar?: boolean;
+  title?: string;
+  actions?: React$1.ReactNode;
+  showColumnToggle?: boolean;
+  showRefresh?: boolean;
+  onRefresh?: () => void;
+  showExport?: boolean;
+  onExport?: () => void;
+  height?: number | string;
+  minHeight?: number | string;
+  maxHeight?: number | string;
+}
+declare function DataTable<T = any>({
+  data,
+  columns: initialColumns,
+  loading,
+  emptyMessage,
+  selectable,
+  selectedRows,
+  onRowSelect,
+  sortable,
+  sort,
+  onSortChange,
+  filterable,
+  filters,
+  onFiltersChange,
+  filterPlaceholder,
+  paginate,
+  page,
+  pageSize,
+  totalRecords,
+  pageSizeOptions,
+  onPageChange,
+  onPageSizeChange,
+  rowActions,
+  onRowClick,
+  rowClassName,
+  showHeader,
+  showFooter,
+  stickyHeader,
+  striped,
+  highlightOnHover,
+  showToolbar,
+  title,
+  actions,
+  showColumnToggle,
+  showRefresh,
+  onRefresh,
+  showExport,
+  onExport,
+  height,
+  minHeight,
+  maxHeight,
+  ...tableProps
+}: DataTableProps<T>): react_jsx_runtime6.JSX.Element;
+//#endregion
+//#region src/services/DialogService.d.ts
+interface BaseDialogOptions extends Partial<ModalProps> {
+  title?: ReactNode;
+  message?: ReactNode;
+  content?: any;
+}
+interface AlertDialogOptions extends BaseDialogOptions {
+  okLabel?: string;
+}
+interface ConfirmDialogOptions extends BaseDialogOptions {
+  confirmLabel?: string;
+  cancelLabel?: string;
+  confirmColor?: string;
+}
+interface PromptDialogOptions extends BaseDialogOptions {
+  placeholder?: string;
+  defaultValue?: string;
+  label?: string;
+  required?: boolean;
+  submitLabel?: string;
+  cancelLabel?: string;
+}
+interface AlertDialogProps {
+  options?: AlertDialogOptions;
+  onClose: () => void;
+}
+interface ConfirmDialogProps {
+  options?: ConfirmDialogOptions;
+  onConfirm: (confirmed: boolean) => void;
+}
+interface PromptDialogProps {
+  options?: PromptDialogOptions;
+  onSubmit: (value: string | null) => void;
+}
+interface DialogServiceOptions {
+  default?: Partial<BaseDialogOptions>;
+}
+declare class DialogService {
+  readonly options: DialogServiceOptions;
+  /**
+   * Show an alert dialog with a message
+   */
+  alert(options?: AlertDialogOptions): Promise<void>;
+  /**
+   * Show a confirmation dialog that returns a promise
+   */
+  confirm(options?: ConfirmDialogOptions): Promise<boolean>;
+  /**
+   * Show a prompt dialog to get user input
+   */
+  prompt(options?: PromptDialogOptions): Promise<string | null>;
+  /**
+   * Open a custom dialog with provided content
+   */
+  open(options?: BaseDialogOptions): string;
+  /**
+   * Show a JSON editor/viewer dialog
+   */
+  json(data?: any, options?: BaseDialogOptions): void;
+  /**
+   * Show a form dialog for structured input
+   */
+  form(options?: BaseDialogOptions): Promise<any>;
+  /**
+   * Close the currently open dialog or a specific dialog by ID
+   */
+  close(modalId?: string): void;
+  /**
+   * Show a loading/progress dialog with optional progress percentage
+   */
+  loading(options?: BaseDialogOptions & {
+    progress?: number;
+  }): void;
+  /**
+   * Show an image viewer/gallery dialog
+   */
+  image(src: string | string[], options?: BaseDialogOptions): void;
+  /**
+   * Show a table/data grid dialog for displaying tabular data
+   */
+  table(data: any[], options?: BaseDialogOptions & {
+    columns?: any[];
+  }): void;
+  /**
+   * Show a multi-step wizard dialog
+   */
+  wizard(steps: any[], options?: BaseDialogOptions): Promise<any>;
+}
+//#endregion
+//#region src/components/dialogs/AlertDialog.d.ts
+declare function AlertDialog({
+  options,
+  onClose
+}: AlertDialogProps): react_jsx_runtime6.JSX.Element;
+//#endregion
+//#region src/components/dialogs/ConfirmDialog.d.ts
+declare function ConfirmDialog({
+  options,
+  onConfirm
+}: ConfirmDialogProps): react_jsx_runtime6.JSX.Element;
+//#endregion
+//#region src/components/dialogs/PromptDialog.d.ts
+declare function PromptDialog({
+  options,
+  onSubmit
+}: PromptDialogProps): react_jsx_runtime6.JSX.Element;
+//#endregion
+//#region src/components/Sidebar.d.ts
+interface MenuItem {
+  id: string;
+  label: string;
+  icon?: ReactNode;
+  href?: string;
+  activeStartsWith?: boolean;
+  onClick?: () => void;
+  children?: MenuItem[];
+}
+interface SidebarProps {
+  menu: MenuItem[];
+  defaultOpenIds?: string[];
+  onItemClick?: (item: MenuItem) => void;
+  showSearchButton?: boolean;
+  onSearchClick?: () => void;
+}
+declare const Sidebar: FC<SidebarProps>;
+interface SidebarItemProps {
+  item: MenuItem;
+  level: number;
+  openIds: Set<string>;
+  onToggle: (id: string) => void;
+  onItemClick?: (item: MenuItem) => void;
+}
+declare const SidebarItem: React.FC<SidebarItemProps>;
 //#endregion
 //#region src/components/TypeForm.d.ts
-interface TypeFormProps<T$1 extends TObject> {
-  form: FormModel<T$1>;
+interface TypeFormProps<T extends TObject> {
+  form: FormModel<T>;
   columns?: number | {
     base?: number;
     xs?: number;
@@ -171,11 +477,12 @@ interface TypeFormProps<T$1 extends TObject> {
     lg?: number;
     xl?: number;
   };
-  children?: (input: FormModel<T$1>["input"]) => ReactNode;
+  children?: (input: FormModel<T>["input"]) => ReactNode;
   controlProps?: Partial<Omit<ControlProps, "input">>;
   skipFormElement?: boolean;
   skipSubmitButton?: boolean;
   submitButtonProps?: Partial<Omit<ActionSubmitProps, "form">>;
+  resetButtonProps?: Partial<Omit<ActionSubmitProps, "form">>;
 }
 /**
  * TypeForm component that automatically renders all form inputs based on schema.
@@ -202,7 +509,19 @@ interface TypeFormProps<T$1 extends TObject> {
  * return <TypeForm form={form} columns={2} />;
  * ```
  */
-declare const TypeForm: <T extends TObject>(props: TypeFormProps<T>) => react_jsx_runtime0.JSX.Element | null;
+declare const TypeForm: <T extends TObject>(props: TypeFormProps<T>) => react_jsx_runtime6.JSX.Element | null;
+//#endregion
+//#region src/hooks/useDialog.d.ts
+/**
+ * Use this hook to access the Dialog Service for showing various dialog types.
+ *
+ * @example
+ * const dialog = useDialog();
+ * await dialog.alert({ title: "Alert", message: "This is an alert message" });
+ * const confirmed = await dialog.confirm({ title: "Confirm", message: "Are you sure?" });
+ * const input = await dialog.prompt({ title: "Input", message: "Enter your name:" });
+ */
+declare const useDialog: () => DialogService;
 //#endregion
 //#region src/services/ToastService.d.ts
 interface ToastServiceOptions {
@@ -290,11 +609,11 @@ declare module "typebox" {
   }
 }
 /**
- *
+ * Mantine
  *
  * @module alepha.ui
  */
 declare const AlephaUI: _alepha_core0.Service<_alepha_core0.Module<{}>>;
 //#endregion
-export { Action, AlephaMantineProvider, AlephaUI, Control, ControlDate, ControlSelect, DarkModeButton, Flex, ICON_SIZES, IconSize, Omnibar, RootRouter, ToastService, TypeForm, capitalize, getDefaultIcon, prettyName, useToast };
+export { Action, AlephaMantineProvider, AlephaUI, AlertDialog, type AlertDialogOptions, type AlertDialogProps, type BaseDialogOptions, ConfirmDialog, type ConfirmDialogOptions, type ConfirmDialogProps, Control, ControlDate, ControlSelect, DarkModeButton, DataTable, type DataTableColumn, type DataTableFilter, type DataTableProps, type DataTableSort, DialogService, Flex, ICON_SIZES, IconSize, type MenuItem, Omnibar, PromptDialog, type PromptDialogOptions, type PromptDialogProps, RootRouter, Sidebar, SidebarItem, type SidebarItemProps, type SidebarProps, ToastService, TypeForm, capitalize, getDefaultIcon, prettyName, useDialog, useToast };
 //# sourceMappingURL=index.d.ts.map

package/vite.d.ts

@@ -1,8 +1,13 @@
+import { Alepha } from "alepha";
 import { Options } from "@vitejs/plugin-react";
 import { BrotliOptions, ZlibOptions } from "node:zlib";
-import { Alepha } from "alepha";
 import { Plugin, UserConfig } from "vite";
 
+//#region src/helpers/getEntryFiles.d.ts
+declare const getClientEntry: (root?: string) => Promise<string | undefined>;
+declare const getServerEntry: (root?: string) => Promise<string>;
+declare function extractFirstModuleScriptSrc(html: string): string;
+//#endregion
 //#region src/viteCompress.d.ts
 interface ViteCompressOptions {
   /**
@@ -188,5 +193,5 @@ declare global {
 //# sourceMappingURL=index.d.ts.map
 
 //#endregion
-export { VercelConfig, ViteAlephaBuildOptions, ViteAlephaBuildVercelOptions, ViteAlephaDevOptions, ViteAlephaOptions, ViteCompressOptions, compressFile, viteAlepha, viteAlephaBuild, viteAlephaBuildVercel, viteAlephaDev, viteCompress };
+export { VercelConfig, ViteAlephaBuildOptions, ViteAlephaBuildVercelOptions, ViteAlephaDevOptions, ViteAlephaOptions, ViteCompressOptions, compressFile, extractFirstModuleScriptSrc, getClientEntry, getServerEntry, viteAlepha, viteAlephaBuild, viteAlephaBuildVercel, viteAlephaDev, viteCompress };
 //# sourceMappingURL=index.d.ts.map