@alepha/ui 0.11.9 → 0.11.11

package/dist/index.d.cts

@@ -0,0 +1,813 @@
+import * as _alepha_core0 from "@alepha/core";
+import { Alepha, Async, Page, PageMetadata, Static, TObject, TProperties } from "@alepha/core";
+import { ComponentType, ReactNode } from "react";
+import * as react_jsx_runtime5 from "react/jsx-runtime";
+import { AppShellFooterProps, AppShellHeaderProps, AppShellMainProps, AppShellNavbarProps, AppShellProps, AutocompleteProps, ButtonProps, ColorInputProps, ColorSchemeScriptProps, FileInputProps, Flex, FlexProps, MantineBreakpoint, MantineProviderProps, MantineSize, MenuProps, MenuTargetProps, ModalProps, MultiSelectProps, NumberInputProps, PasswordInputProps, SegmentedControlProps, SelectProps, SliderProps, SwitchProps, TableProps, TableTrProps, TagsInputProps, Text, TextInputProps, TextareaProps, ThemeIconProps, TooltipProps } from "@mantine/core";
+import { DateInputProps, DateTimePickerProps, TimeInputProps } from "@mantine/dates";
+import { FormModel, InputField } from "@alepha/react-form";
+import * as _alepha_react0 from "@alepha/react";
+import { RouterGoOptions, UseActionReturn, UseActiveOptions } from "@alepha/react";
+import { ModalsProviderProps } from "@mantine/modals";
+import * as _mantine_notifications0 from "@mantine/notifications";
+import { NotificationData, NotificationsProps } from "@mantine/notifications";
+import { NavigationProgressProps } from "@mantine/nprogress";
+import { DurationLike } from "@alepha/datetime";
+
+//#region src/utils/parseInput.d.ts
+interface GenericControlProps {
+  input: InputField;
+  title?: string;
+  description?: string;
+  icon?: ReactNode;
+}
+//#endregion
+//#region src/components/form/ControlNumber.d.ts
+interface ControlNumberProps extends GenericControlProps {
+  numberInputProps?: Partial<NumberInputProps>;
+  sliderProps?: Partial<SliderProps>;
+}
+//#endregion
+//#region src/components/form/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_runtime5.JSX.Element | null;
+//#endregion
+//#region src/components/form/Control.d.ts
+interface ControlProps extends GenericControlProps {
+  text?: TextInputProps;
+  area?: boolean | TextareaProps;
+  select?: boolean | Partial<ControlSelectProps>;
+  password?: boolean | PasswordInputProps;
+  switch?: boolean | SwitchProps;
+  number?: boolean | Partial<ControlNumberProps>;
+  file?: boolean | FileInputProps;
+  color?: boolean | ColorInputProps;
+  date?: boolean | DateInputProps;
+  datetime?: boolean | DateTimePickerProps;
+  time?: boolean | TimeInputProps;
+  query?: any;
+  custom?: ComponentType<CustomControlProps>;
+}
+/**
+ * Generic form control that renders the appropriate input based on the schema and props.
+ *
+ * Supports:
+ * - TextInput (with format detection: email, url, tel)
+ * - Textarea
+ * - NumberInput (for number/integer types)
+ * - FileInput
+ * - ColorInput (for color format)
+ * - Select (for enum types)
+ * - Autocomplete
+ * - PasswordInput
+ * - Switch (for boolean types)
+ * - SegmentedControl (for enum types)
+ * - DateInput (for date format)
+ * - DateTimePicker (for date-time format)
+ * - TimeInput (for time format)
+ * - QueryBuilder (for building type-safe queries with autocomplete)
+ * - Custom component
+ *
+ * Automatically handles labels, descriptions, error messages, required state, and default icons.
+ */
+declare const Control: (_props: ControlProps) => react_jsx_runtime5.JSX.Element | null;
+type CustomControlProps = {
+  defaultValue: any;
+  onChange: (value: any) => void;
+};
+//#endregion
+//#region src/components/buttons/ActionButton.d.ts
+interface ActionMenuItem {
+  /**
+   * Menu item type
+   */
+  type?: "item" | "divider" | "label";
+  /**
+   * Label text for the menu item
+   */
+  label?: string | ReactNode;
+  /**
+   * Icon element to display before the label
+   */
+  icon?: ReactNode;
+  /**
+   * Click handler for menu items
+   */
+  onClick?: () => void;
+  /**
+   * Href for navigation menu items
+   */
+  href?: string;
+  /**
+   * Color for the menu item (e.g., "red" for danger actions)
+   */
+  color?: string;
+  /**
+   * Nested submenu items
+   */
+  children?: ActionMenuItem[];
+  /**
+   * Whether the menu item is active
+   */
+  active?: boolean;
+}
+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";
+  on?: "hover" | "click";
+  targetProps?: MenuTargetProps;
+  menuProps?: MenuProps;
+}
+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.
+   * If a string, it will be used as the message with a default title.
+   * If an object, it can contain `title` and `message` properties to customize the dialog.
+   */
+  confirm?: boolean | string | {
+    title?: string;
+    message: string;
+  };
+  /**
+   * Icon to display on the left side of the button.
+   * If no children are provided, the button will be styled as an icon-only button.
+   */
+  icon?: ReactNode;
+  /**
+   * Additional props to pass to the ThemeIcon wrapping the icon.
+   */
+  themeIconProps?: ThemeIconProps;
+}
+type ActionProps = ActionCommonProps & (ActionNavigationButtonProps | ActionClickButtonProps | ActionSubmitButtonProps | ActionHookButtonProps | {});
+declare const ActionButton: (_props: ActionProps) => react_jsx_runtime5.JSX.Element;
+interface ActionSubmitButtonProps extends ButtonProps {
+  form: FormModel<any>;
+  type?: "submit" | "reset";
+}
+interface ActionHookButtonProps extends ButtonProps {
+  action: UseActionReturn<any[], any>;
+}
+interface ActionClickButtonProps extends ButtonProps {
+  onClick: (e: any) => any;
+}
+interface ActionNavigationButtonProps extends ButtonProps {
+  href: string;
+  active?: Partial<UseActiveOptions> | false;
+  routerGoOptions?: RouterGoOptions;
+  classNameActive?: string;
+  variantActive?: ButtonProps["variant"];
+  target?: string;
+}
+//#endregion
+//#region src/components/buttons/DarkModeButton.d.ts
+interface DarkModeButtonProps {
+  mode?: "minimal" | "segmented";
+  size?: MantineBreakpoint;
+  variant?: "filled" | "light" | "outline" | "default" | "subtle" | "transparent";
+  fullWidth?: boolean;
+  segmentedProps?: Partial<SegmentedControlProps>;
+  actionProps?: Partial<ActionProps>;
+}
+declare const DarkModeButton: (props: DarkModeButtonProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/buttons/OmnibarButton.d.ts
+interface OmnibarButtonProps {
+  actionProps?: ActionProps;
+  collapsed?: boolean;
+}
+declare const OmnibarButton: (props: OmnibarButtonProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/data/JsonViewer.d.ts
+interface JsonViewerProps {
+  data: any;
+  defaultExpanded?: boolean;
+  maxDepth?: number;
+  copyable?: boolean;
+  size?: MantineSize;
+}
+declare const JsonViewer: ({
+  data,
+  defaultExpanded,
+  maxDepth,
+  copyable,
+  size
+}: JsonViewerProps) => react_jsx_runtime5.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;
+  /**
+   * Close the currently open dialog or a specific dialog by ID
+   */
+  close(modalId?: string): void;
+  /**
+   * Show a JSON editor/viewer dialog
+   */
+  json(data?: any, options?: BaseDialogOptions): void;
+  /**
+   * Show a form dialog for structured input
+   */
+  form(options?: BaseDialogOptions): Promise<any>;
+  /**
+   * 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;
+}
+//#endregion
+//#region src/components/dialogs/AlertDialog.d.ts
+declare const AlertDialog: ({
+  options,
+  onClose
+}: AlertDialogProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/dialogs/ConfirmDialog.d.ts
+declare const ConfirmDialog: ({
+  options,
+  onConfirm
+}: ConfirmDialogProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/dialogs/PromptDialog.d.ts
+declare const PromptDialog: ({
+  options,
+  onSubmit
+}: PromptDialogProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/form/ControlDate.d.ts
+interface ControlDateProps extends GenericControlProps {
+  date?: boolean | DateInputProps;
+  datetime?: boolean | DateTimePickerProps;
+  time?: boolean | TimeInputProps;
+}
+/**
+ * ControlDate component for handling date, datetime, and time inputs.
+ *
+ * Features:
+ * - DateInput for date format
+ * - DateTimePicker for date-time format
+ * - TimeInput for time format
+ *
+ * Automatically detects date formats from schema and renders appropriate picker.
+ */
+declare const ControlDate: (props: ControlDateProps) => react_jsx_runtime5.JSX.Element | null;
+//#endregion
+//#region src/components/form/ControlQueryBuilder.d.ts
+interface ControlQueryBuilderProps extends Omit<TextInputProps, "value" | "onChange"> {
+  schema?: TObject;
+  value?: string;
+  onChange?: (value: string) => void;
+  placeholder?: string;
+}
+/**
+ * Query builder with text input and help popover.
+ * Generates query strings for parseQueryString syntax.
+ */
+declare const ControlQueryBuilder: ({
+  schema,
+  value,
+  onChange,
+  placeholder,
+  ...textInputProps
+}: ControlQueryBuilderProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/form/TypeForm.d.ts
+interface TypeFormProps<T extends TObject> {
+  form: FormModel<T>;
+  columns?: number | {
+    base?: number;
+    xs?: number;
+    sm?: number;
+    md?: number;
+    lg?: number;
+    xl?: number;
+  };
+  schema?: TObject;
+  children?: (input: FormModel<T>["input"]) => ReactNode;
+  controlProps?: Partial<Omit<ControlProps, "input">>;
+  skipFormElement?: boolean;
+  skipSubmitButton?: boolean;
+  submitButtonProps?: Partial<Omit<ActionSubmitButtonProps, "form">>;
+  resetButtonProps?: Partial<Omit<ActionSubmitButtonProps, "form">>;
+}
+/**
+ * TypeForm component that automatically renders all form inputs based on schema.
+ * Uses the Control component to render individual fields and Mantine Grid for responsive layout.
+ *
+ * @example
+ * ```tsx
+ * import { t } from "alepha";
+ * import { useForm } from "@alepha/react-form";
+ * import { TypeForm } from "@alepha/ui";
+ *
+ * const form = useForm({
+ *   schema: t.object({
+ *     username: t.text(),
+ *     email: t.text(),
+ *     age: t.integer(),
+ *     subscribe: t.boolean(),
+ *   }),
+ *   handler: (values) => {
+ *     console.log(values);
+ *   },
+ * });
+ *
+ * return <TypeForm form={form} columns={2} />;
+ * ```
+ */
+declare const TypeForm: <T extends TObject>(props: TypeFormProps<T>) => react_jsx_runtime5.JSX.Element | null;
+//#endregion
+//#region src/components/buttons/LanguageButton.d.ts
+interface LanguageButtonProps {
+  languages?: string[];
+  actionProps?: ActionProps;
+}
+//#endregion
+//#region src/components/layout/AppBar.d.ts
+type AppBarItem = AppBarElement | AppBarBurger | AppBarDark | AppBarSearch | AppBarLang | AppBarSpacer | AppBarDivider;
+interface AppBarElement {
+  position: "left" | "center" | "right";
+  element: ReactNode;
+}
+interface AppBarBurger {
+  position: "left" | "center" | "right";
+  type: "burger";
+}
+interface AppBarDark {
+  position: "left" | "center" | "right";
+  type: "dark";
+  props?: DarkModeButtonProps;
+}
+interface AppBarSearch {
+  position: "left" | "center" | "right";
+  type: "search";
+  props?: OmnibarButtonProps;
+}
+interface AppBarLang {
+  position: "left" | "center" | "right";
+  type: "lang";
+  props?: LanguageButtonProps;
+}
+interface AppBarSpacer {
+  position: "left" | "center" | "right";
+  type: "spacer";
+}
+interface AppBarDivider {
+  position: "left" | "center" | "right";
+  type: "divider";
+}
+interface AppBarProps {
+  flexProps?: FlexProps;
+  items?: AppBarItem[];
+}
+declare const AppBar: (props: AppBarProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/layout/Sidebar.d.ts
+interface SidebarProps {
+  menu?: SidebarNode[];
+  top?: SidebarNode[];
+  bottom?: SidebarNode[];
+  onItemClick?: (item: SidebarMenuItem) => void;
+  onSearchClick?: () => void;
+  theme?: SidebarTheme;
+  flexProps?: Partial<FlexProps>;
+  collapsed?: boolean;
+  gap?: MantineBreakpoint;
+}
+declare const Sidebar: (props: SidebarProps) => react_jsx_runtime5.JSX.Element;
+interface SidebarItemProps {
+  item: SidebarMenuItem;
+  level: number;
+  onItemClick?: (item: SidebarMenuItem) => void;
+  theme: SidebarTheme;
+}
+interface SidebarItemProps {
+  item: SidebarMenuItem;
+  level: number;
+  onItemClick?: (item: SidebarMenuItem) => void;
+  theme: SidebarTheme;
+}
+type SidebarNode = SidebarMenuItem | SidebarSpacer | SidebarDivider | SidebarSearch | SidebarElement | SidebarSection;
+interface SidebarAbstractItem {
+  position?: "top" | "bottom";
+}
+interface SidebarElement extends SidebarAbstractItem {
+  element: ReactNode;
+}
+interface SidebarSpacer extends SidebarAbstractItem {
+  type: "spacer";
+}
+interface SidebarDivider extends SidebarAbstractItem {
+  type: "divider";
+}
+interface SidebarSearch extends SidebarAbstractItem {
+  type: "search";
+}
+interface SidebarSection extends SidebarAbstractItem {
+  type: "section";
+  label: string;
+  icon?: ReactNode;
+}
+interface SidebarMenuItem extends SidebarAbstractItem {
+  label: string | ReactNode;
+  description?: string;
+  icon?: ReactNode;
+  href?: string;
+  target?: "_blank" | "_self" | "_parent" | "_top";
+  activeStartsWith?: boolean;
+  onClick?: () => void;
+  children?: SidebarMenuItem[];
+  rightSection?: ReactNode;
+  theme?: SidebarButtonTheme;
+  actionProps?: ActionProps;
+}
+interface SidebarButtonTheme {
+  radius?: MantineBreakpoint;
+  size?: MantineBreakpoint;
+}
+interface SidebarTheme {
+  button?: SidebarButtonTheme;
+  search?: SidebarButtonTheme;
+}
+//#endregion
+//#region src/components/layout/AdminShell.d.ts
+interface AdminShellProps {
+  appShellProps?: Partial<AppShellProps>;
+  appShellMainProps?: Partial<AppShellMainProps>;
+  appShellHeaderProps?: Partial<AppShellHeaderProps>;
+  appShellNavbarProps?: Partial<AppShellNavbarProps>;
+  appShellFooterProps?: Partial<AppShellFooterProps>;
+  sidebarProps?: Partial<SidebarProps>;
+  appBarProps?: Partial<AppBarProps>;
+  header?: ReactNode;
+  footer?: ReactNode;
+  children?: ReactNode;
+}
+declare module "@alepha/core" {
+  interface State {
+    /**
+     * Whether the sidebar is opened or closed.
+     */
+    "alepha.ui.sidebar.opened"?: boolean;
+    /**
+     * Whether the sidebar is collapsed (narrow) or expanded (wide).
+     */
+    "alepha.ui.sidebar.collapsed"?: boolean;
+  }
+}
+declare const AdminShell: (props: AdminShellProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/layout/Omnibar.d.ts
+interface OmnibarProps {
+  shortcut?: string | string[];
+  searchPlaceholder?: string;
+  nothingFound?: ReactNode;
+}
+declare const Omnibar: (props: OmnibarProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/layout/AlephaMantineProvider.d.ts
+interface AlephaMantineProviderProps {
+  children?: ReactNode;
+  mantine?: MantineProviderProps;
+  colorSchemeScript?: ColorSchemeScriptProps;
+  navigationProgress?: NavigationProgressProps;
+  notifications?: NotificationsProps;
+  modals?: ModalsProviderProps;
+  omnibar?: OmnibarProps;
+}
+declare const AlephaMantineProvider: (props: AlephaMantineProviderProps) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/components/table/DataTable.d.ts
+interface DataTableColumnContext<Filters extends TObject> {
+  index: number;
+  form: FormModel<Filters>;
+  alepha: Alepha;
+}
+interface DataTableColumn<T extends object, Filters extends TObject> {
+  label: string;
+  value: (item: T, ctx: DataTableColumnContext<Filters>) => ReactNode;
+  fit?: boolean;
+}
+type MaybePage<T> = Omit<Page<T>, "page"> & {
+  page?: Partial<PageMetadata>;
+};
+interface DataTableSubmitContext<T extends object> {
+  items: T[];
+}
+interface DataTableProps<T extends object, Filters extends TObject> {
+  /**
+   * The items to display in the table. Can be a static page of items or a function that returns a promise resolving to a page of items.
+   */
+  items: MaybePage<T> | ((filters: Static<Filters> & {
+    page: number;
+    size: number;
+    sort?: string;
+  }, ctx: DataTableSubmitContext<T>) => Async<MaybePage<T>>);
+  /**
+   * The columns to display in the table. Each column is defined by a key and a DataTableColumn object.
+   */
+  columns: {
+    [key: string]: DataTableColumn<T, Filters>;
+  };
+  defaultSize?: number;
+  typeFormProps?: Partial<Omit<TypeFormProps<Filters>, "form">>;
+  onFilterChange?: (key: string, value: unknown, form: FormModel<Filters>) => void;
+  /**
+   * Optional filters to apply to the data.
+   */
+  filters?: TObject;
+  panel?: (item: T) => ReactNode;
+  canPanel?: (item: T) => boolean;
+  submitOnInit?: boolean;
+  submitEvery?: DurationLike;
+  withLineNumbers?: boolean;
+  withCheckbox?: boolean;
+  checkboxActions?: any[];
+  actions?: any[];
+  /**
+   * Enable infinity scroll mode. When true, pagination controls are hidden and new items are loaded automatically when scrolling to the bottom.
+   */
+  infinityScroll?: boolean;
+  /**
+   * Props to pass to the Mantine Table component.
+   */
+  tableProps?: TableProps;
+  /**
+   * Function to generate props for each table row based on the item.
+   */
+  tableTrProps?: (item: T) => TableTrProps;
+}
+declare const DataTable: <T extends object, Filters extends TObject>(props: DataTableProps<T, Filters>) => react_jsx_runtime5.JSX.Element;
+//#endregion
+//#region src/constants/ui.d.ts
+declare const ui: {
+  colors: {
+    transparent: string;
+    background: string;
+    surface: string;
+    elevated: string;
+    border: string;
+  };
+};
+//#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 {
+  default?: Partial<NotificationData>;
+}
+declare class ToastService {
+  protected readonly raw: {
+    readonly show: typeof _mantine_notifications0.showNotification;
+    readonly hide: typeof _mantine_notifications0.hideNotification;
+    readonly update: typeof _mantine_notifications0.updateNotification;
+    readonly clean: typeof _mantine_notifications0.cleanNotifications;
+    readonly cleanQueue: typeof _mantine_notifications0.cleanNotificationsQueue;
+    readonly updateState: typeof _mantine_notifications0.updateNotificationsState;
+  };
+  readonly options: ToastServiceOptions;
+  show(options: NotificationData): void;
+  info(options: Partial<NotificationData> | string): void;
+  success(options: Partial<NotificationData> | string): void;
+  warning(options: Partial<NotificationData> | string): void;
+  danger(options: Partial<NotificationData> | string): void;
+}
+//#endregion
+//#region src/hooks/useToast.d.ts
+/**
+ * Use this hook to access the Toast Service for showing notifications.
+ *
+ * @example
+ * const toast = useToast();
+ * toast.success({ message: "Operation completed successfully!" });
+ * toast.error({ title: "Error", message: "Something went wrong" });
+ */
+declare const useToast: () => ToastService;
+//#endregion
+//#region src/RootRouter.d.ts
+declare class RootRouter {
+  readonly root: _alepha_react0.PageDescriptor<_alepha_react0.PageConfigSchema, any, _alepha_react0.TPropsParentDefault>;
+}
+//#endregion
+//#region src/utils/extractSchemaFields.d.ts
+interface SchemaField {
+  name: string;
+  path: string;
+  type: string;
+  enum?: readonly any[];
+  format?: string;
+  description?: string;
+  nested?: SchemaField[];
+}
+/**
+ * Extract field information from a TypeBox schema for query building.
+ * Supports nested objects and provides field metadata for autocomplete.
+ */
+declare function extractSchemaFields(schema: TObject | TProperties, prefix?: string): SchemaField[];
+/**
+ * Get suggested operators based on field type
+ */
+declare function getOperatorsForField(field: SchemaField): string[];
+/**
+ * Get operator symbol and description
+ */
+declare const OPERATOR_INFO: Record<string, {
+  symbol: string;
+  label: string;
+  example: string;
+}>;
+//#endregion
+//#region src/utils/icons.d.ts
+/**
+ * Icon size presets following Mantine's size conventions
+ */
+declare const ICON_SIZES: {
+  readonly xs: 12;
+  readonly sm: 16;
+  readonly md: 20;
+  readonly lg: 24;
+  readonly xl: 28;
+};
+type IconSize = keyof typeof ICON_SIZES;
+/**
+ * Get the default icon for an input based on its type, format, or name.
+ */
+declare const getDefaultIcon: (params: {
+  type?: string;
+  format?: string;
+  name?: string;
+  isEnum?: boolean;
+  isArray?: boolean;
+  size?: IconSize;
+}) => ReactNode;
+//#endregion
+//#region src/utils/string.d.ts
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @example
+ * capitalize("hello") // "Hello"
+ */
+declare const capitalize: (str: string) => string;
+/**
+ * Converts a path or identifier string into a pretty display name.
+ * Removes slashes and capitalizes the first letter.
+ *
+ * @example
+ * prettyName("/userName") // "UserName"
+ * prettyName("email") // "Email"
+ */
+declare const prettyName: (name: string) => string;
+//#endregion
+//#region src/index.d.ts
+declare module "typebox" {
+  interface TSchemaOptions {
+    $control?: Omit<ControlProps, "input">;
+  }
+}
+declare module "@alepha/react" {
+  interface PageDescriptorOptions {
+    /**
+     * Human-readable title for the page.
+     * - for Sidebar navigation
+     * - for Omnibar navigation
+     * (soon)
+     * - for Breadcrumbs
+     * - for document title (with AlephaReactHead)
+     */
+    label?: string;
+    /**
+     * Optional description of the page.
+     */
+    description?: string;
+    /**
+     * Optional icon for the page.
+     */
+    icon?: ReactNode;
+  }
+}
+/**
+ * Mantine
+ *
+ * @module alepha.ui
+ */
+declare const AlephaUI: _alepha_core0.Service<_alepha_core0.Module>;
+//#endregion
+export { ActionButton, type ActionClickButtonProps, type ActionCommonProps, type ActionMenuConfig, type ActionMenuItem, type ActionNavigationButtonProps, type ActionProps, type ActionSubmitButtonProps, AdminShell, AlephaMantineProvider, AlephaUI, AlertDialog, type AlertDialogOptions, type AlertDialogProps, AppBar, type AppBarBurger, type AppBarDark, type AppBarDivider, type AppBarElement, type AppBarItem, type AppBarLang, type AppBarProps, type AppBarSearch, type AppBarSpacer, type BaseDialogOptions, ConfirmDialog, type ConfirmDialogOptions, type ConfirmDialogProps, Control, ControlDate, ControlQueryBuilder, ControlSelect, DarkModeButton, DataTable, type DataTableColumn, type DataTableProps, DialogService, Flex, ICON_SIZES, IconSize, JsonViewer, OPERATOR_INFO, Omnibar, OmnibarButton, PromptDialog, type PromptDialogOptions, type PromptDialogProps, RootRouter, SchemaField, Sidebar, type SidebarAbstractItem, type SidebarButtonTheme, type SidebarDivider, type SidebarElement, type SidebarItemProps, type SidebarMenuItem, type SidebarNode, type SidebarProps, type SidebarSearch, type SidebarSection, type SidebarSpacer, type SidebarTheme, Text, ToastService, TypeForm, capitalize, extractSchemaFields, getDefaultIcon, getOperatorsForField, prettyName, ui, useDialog, useToast };
+//# sourceMappingURL=index.d.cts.map