@alepha/ui 0.15.0 → 0.15.2

package/dist/core/index.d.ts

@@ -1,21 +1,64 @@
-import { BaseInputField, FormModel } from "@alepha/react/form";
-import * as _alepha_react_head0 from "@alepha/react/head";
 import * as alepha1 from "alepha";
 import { Alepha, Async, Page, PageMetadata, Static, TObject, TProperties } from "alepha";
+import { BaseInputField, FormModel } from "alepha/react/form";
+import * as alepha_react_head0 from "alepha/react/head";
 import * as alepha_server_cookies0 from "alepha/server/cookies";
-import * as _alepha_react_router0 from "@alepha/react/router";
-import { RouterGoOptions, UseActiveOptions } from "@alepha/react/router";
-import { UseActionReturn } from "@alepha/react";
+import * as alepha_react_router0 from "alepha/react/router";
+import { RouterGoOptions, UseActiveOptions } from "alepha/react/router";
 import { AnchorProps, AppShellFooterProps, AppShellHeaderProps, AppShellMainProps, AppShellNavbarProps, AppShellProps, AutocompleteProps, BurgerProps, ButtonProps, ColorInputProps, ColorSchemeScriptProps, FileInputProps, Flex, FlexProps, MantineBreakpoint, MantineProviderProps, MantineThemeOverride, MenuProps, MenuTargetProps, ModalProps, MultiSelectProps, NumberInputProps, PasswordInputProps, SegmentedControlProps, SelectProps, SliderProps, SwitchProps, TableProps, TableTrProps, TagsInputProps, Text, TextInputProps, TextareaProps, ThemeIconProps, TooltipProps } from "@mantine/core";
 import { ModalsProviderProps } from "@mantine/modals";
 import * as _mantine_notifications0 from "@mantine/notifications";
 import { NotificationData, NotificationsProps } from "@mantine/notifications";
 import { NavigationProgressProps } from "@mantine/nprogress";
-import * as react_jsx_runtime12 from "react/jsx-runtime";
+import { UseActionReturn } from "alepha/react";
+import * as react_jsx_runtime11 from "react/jsx-runtime";
 import { ComponentType, ReactElement, ReactNode } from "react";
 import { DateInputProps, DateTimePickerProps, TimeInputProps } from "@mantine/dates";
 import { DurationLike } from "alepha/datetime";
 
+//#region ../../src/core/atoms/alephaSidebarAtom.d.ts
+declare const alephaSidebarAtom: alepha1.Atom<alepha1.TObject<{
+  /**
+   * Whether the sidebar is opened or closed (mobile).
+   */
+  opened: alepha1.TBoolean;
+  /**
+   * Whether the sidebar is collapsed (narrow) or expanded (wide).
+   */
+  collapsed: alepha1.TBoolean;
+  /**
+   * Current width of the sidebar when expanded (can be changed by resizing).
+   * @default 300
+   */
+  width: alepha1.TNumber;
+  /**
+   * Default width used when expanding from collapsed state or on hover.
+   * @default 300
+   */
+  defaultWidth: alepha1.TNumber;
+  /**
+   * Width of the sidebar when collapsed.
+   * @default 78
+   */
+  collapsedWidth: alepha1.TNumber;
+  /**
+   * Maximum width when resizing.
+   * @default 500
+   */
+  maxWidth: alepha1.TNumber;
+  /**
+   * Minimum width before auto-collapse triggers.
+   * @default 150
+   */
+  collapseThreshold: alepha1.TNumber;
+  /**
+   * Delay in ms before sidebar expands on hover when collapsed.
+   * @default 300
+   */
+  hoverDelay: alepha1.TNumber;
+}>, "alepha.ui.sidebar">;
+type AlephaSidebarState = Static<typeof alephaSidebarAtom.schema>;
+//#endregion
 //#region ../../src/core/atoms/alephaThemeAtom.d.ts
 declare const alephaThemeAtom: alepha1.Atom<alepha1.TObject<{
   index: alepha1.TInteger;
@@ -35,45 +78,45 @@ interface GenericControlProps {
 //#region ../../src/core/components/form/ControlArray.d.ts
 interface ControlArrayProps extends GenericControlProps {
   /**
-       * Minimum number of items allowed.
-       * @default 0
-       */
+   * Minimum number of items allowed.
+   * @default 0
+   */
   min?: number;
   /**
-       * Maximum number of items allowed.
-       * @default Infinity
-       */
+   * Maximum number of items allowed.
+   * @default Infinity
+   */
   max?: number;
   /**
-       * Label for the add button.
-       * @default "Add item"
-       */
+   * Label for the add button.
+   * @default "Add item"
+   */
   addLabel?: string;
   /**
-       * Number of columns for object item fields.
-       * @default 1
-       */
+   * Number of columns for object item fields.
+   * @default 1
+   */
   columns?: number;
   /**
-       * Variant for the container.
-       * - "fieldset": Uses Mantine Fieldset with legend
-       * - "plain": No container, just renders items
-       * @default "fieldset"
-       */
+   * Variant for the container.
+   * - "fieldset": Uses Mantine Fieldset with legend
+   * - "plain": No container, just renders items
+   * @default "fieldset"
+   */
   variant?: "fieldset" | "plain";
   /**
-       * Per-field control props override for object items.
-       * Keys are field names from the item schema.
-       */
+   * Per-field control props override for object items.
+   * Keys are field names from the item schema.
+   */
   controlProps?: Record<string, Partial<Omit<ControlProps, "input">>>;
   /**
-       * Control props for primitive items.
-       */
+   * Control props for primitive items.
+   */
   itemControlProps?: Partial<Omit<ControlProps, "input">>;
   /**
-       * Show drag handle for reordering.
-       * @default false
-       */
+   * Show drag handle for reordering.
+   * @default false
+   */
   sortable?: boolean;
 }
 /**
@@ -106,7 +149,7 @@ interface ControlArrayProps extends GenericControlProps {
  * />
  * ```
  */
-declare const ControlArray: (props: ControlArrayProps) => react_jsx_runtime12.JSX.Element | null;
+declare const ControlArray: (props: ControlArrayProps) => react_jsx_runtime11.JSX.Element | null;
 //#endregion
 //#region ../../src/core/components/form/ControlNumber.d.ts
 interface ControlNumberProps extends GenericControlProps {
@@ -116,26 +159,26 @@ interface ControlNumberProps extends GenericControlProps {
 /**
  *
  */
-declare const ControlNumber: (props: ControlNumberProps) => react_jsx_runtime12.JSX.Element | null;
+declare const ControlNumber: (props: ControlNumberProps) => react_jsx_runtime11.JSX.Element | null;
 //#endregion
 //#region ../../src/core/components/form/ControlObject.d.ts
 interface ControlObjectProps extends GenericControlProps {
   /**
-       * Number of columns for the grid layout.
-       * @default 1
-       */
+   * Number of columns for the grid layout.
+   * @default 1
+   */
   columns?: number;
   /**
-       * Variant for the container.
-       * - "fieldset": Uses Mantine Fieldset with legend
-       * - "plain": No container, just renders fields
-       * @default "fieldset"
-       */
+   * Variant for the container.
+   * - "fieldset": Uses Mantine Fieldset with legend
+   * - "plain": No container, just renders fields
+   * @default "fieldset"
+   */
   variant?: "fieldset" | "plain";
   /**
-       * Per-field control props override.
-       * Keys are field names from the schema.
-       */
+   * Per-field control props override.
+   * Keys are field names from the schema.
+   */
   controlProps?: Record<string, Partial<Omit<ControlProps, "input">>>;
 }
 /**
@@ -170,7 +213,7 @@ interface ControlObjectProps extends GenericControlProps {
  * />
  * ```
  */
-declare const ControlObject: (props: ControlObjectProps) => react_jsx_runtime12.JSX.Element | null;
+declare const ControlObject: (props: ControlObjectProps) => react_jsx_runtime11.JSX.Element | null;
 //#endregion
 //#region ../../src/core/components/form/ControlSelect.d.ts
 type SelectValueLabel = string | {
@@ -199,7 +242,7 @@ interface ControlSelectProps extends GenericControlProps {
  *
  * Automatically detects enum values and array types from schema.
  */
-declare const ControlSelect: (props: ControlSelectProps) => react_jsx_runtime12.JSX.Element | null;
+declare const ControlSelect: (props: ControlSelectProps) => react_jsx_runtime11.JSX.Element | null;
 //#endregion
 //#region ../../src/core/components/form/Control.d.ts
 interface ControlProps extends GenericControlProps {
@@ -245,12 +288,17 @@ interface ControlProps extends GenericControlProps {
  *
  * Automatically handles labels, descriptions, error messages, required state, and default icons.
  */
-declare const Control: (_props: ControlProps) => react_jsx_runtime12.JSX.Element | null;
+declare const Control: (_props: ControlProps) => react_jsx_runtime11.JSX.Element | null;
 type CustomControlProps = {
   defaultValue: any;
   onChange: (value: any) => void;
 };
 //#endregion
+//#region ../../src/core/RootRouter.d.ts
+declare class RootRouter {
+  readonly root: alepha_react_router0.PagePrimitive<alepha_react_router0.PageConfigSchema, any, alepha_react_router0.TPropsParentDefault>;
+}
+//#endregion
 //#region ../../src/core/atoms/alephaThemeListAtom.d.ts
 declare const alephaThemeListAtom: alepha1.Atom<alepha1.TArray<alepha1.TRecord<string, alepha1.TAny>>, "alepha.ui.themeList">;
 //#endregion
@@ -270,54 +318,54 @@ declare const midnightTheme: AlephaTheme;
 //#region ../../src/core/components/buttons/ActionButton.d.ts
 interface ActionMenuItem {
   /**
-       * Menu item type
-       */
+   * Menu item type
+   */
   type?: "item" | "divider" | "label";
   /**
-       * Label text for the menu item
-       */
+   * Label text for the menu item
+   */
   label?: string | ReactNode;
   /**
-       * Icon element to display before the label
-       */
+   * Icon element to display before the label
+   */
   icon?: ReactNode;
   /**
-       * Click handler for menu items
-       */
+   * Click handler for menu items
+   */
   onClick?: () => void;
   /**
-       * Href for navigation menu items
-       */
+   * Href for navigation menu items
+   */
   href?: string;
   /**
-       * Color for the menu item (e.g., "red" for danger actions)
-       */
+   * Color for the menu item (e.g., "red" for danger actions)
+   */
   color?: string;
   /**
-       * Nested submenu items
-       */
+   * Nested submenu items
+   */
   children?: ActionMenuItem[];
   /**
-       * Whether the menu item is active
-       */
+   * Whether the menu item is active
+   */
   active?: boolean;
 }
 interface ActionMenuConfig {
   /**
-       * Array of menu items to display
-       */
+   * Array of menu items to display
+   */
   items: ActionMenuItem[];
   /**
-       * Menu position relative to the button
-       */
+   * Menu position relative to the button
+   */
   position?: "bottom" | "bottom-start" | "bottom-end" | "top" | "top-start" | "top-end" | "left" | "right";
   /**
-       * Menu width
-       */
+   * Menu width
+   */
   width?: number | string;
   /**
-       * Menu shadow
-       */
+   * Menu shadow
+   */
   shadow?: "xs" | "sm" | "md" | "lg" | "xl";
   on?: "hover" | "click";
   targetProps?: MenuTargetProps;
@@ -327,40 +375,40 @@ 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 to display on hover. Can be a string for simple tooltips
+   * or a TooltipProps object for advanced configuration.
+   */
   tooltip?: string | number | TooltipProps;
   /**
-       * Menu configuration. When provided, the action will display a dropdown menu.
-       */
+   * 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.
-       */
+   * 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 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 | ComponentType;
   /**
-       * Additional props to pass to the ThemeIcon wrapping the icon.
-       */
+   * Additional props to pass to the ThemeIcon wrapping the icon.
+   */
   themeIconProps?: ThemeIconProps;
   /**
-       * Visual intent of the action button.
-       */
+   * Visual intent of the action button.
+   */
   intent?: "primary" | "success" | "danger" | "warning" | "info" | "none";
 }
 type ActionProps = ActionCommonProps & (ActionNavigationButtonProps | ActionClickButtonProps | ActionSubmitButtonProps | ActionHookButtonProps | {});
-declare const ActionButton: (_props: ActionProps) => react_jsx_runtime12.JSX.Element;
+declare const ActionButton: (_props: ActionProps) => react_jsx_runtime11.JSX.Element;
 interface ActionSubmitButtonProps extends ButtonProps {
   form: FormModel<any>;
   type?: "submit" | "reset";
@@ -383,28 +431,28 @@ interface ActionNavigationButtonProps extends ButtonProps {
 //#endregion
 //#region ../../src/core/components/buttons/BurgerButton.d.ts
 interface BurgerButtonProps extends BurgerProps {}
-declare const BurgerButton: (props: BurgerButtonProps) => react_jsx_runtime12.JSX.Element;
+declare const BurgerButton: (props: BurgerButtonProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/buttons/ClipboardButton.d.ts
 interface ClipboardButtonProps extends Omit<ActionCommonProps, "onClick" | "icon"> {
   /**
-       * The value to copy to the clipboard
-       */
+   * The value to copy to the clipboard
+   */
   value: string;
   /**
-       * Timeout in ms to show the "Copied" state (default: 2000)
-       */
+   * Timeout in ms to show the "Copied" state (default: 2000)
+   */
   timeout?: number;
   /**
-       * Label to show in tooltip when not copied (default: "Copy")
-       */
+   * Label to show in tooltip when not copied (default: "Copy")
+   */
   copyLabel?: string;
   /**
-       * Label to show in tooltip when copied (default: "Copied")
-       */
+   * Label to show in tooltip when copied (default: "Copied")
+   */
   copiedLabel?: string;
 }
-declare const ClipboardButton: (props: ClipboardButtonProps) => react_jsx_runtime12.JSX.Element;
+declare const ClipboardButton: (props: ClipboardButtonProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/buttons/DarkModeButton.d.ts
 interface DarkModeButtonProps {
@@ -415,27 +463,31 @@ interface DarkModeButtonProps {
   segmentedProps?: Partial<SegmentedControlProps>;
   actionProps?: Partial<ActionProps>;
 }
-declare const DarkModeButton: (props: DarkModeButtonProps) => react_jsx_runtime12.JSX.Element;
+declare const DarkModeButton: (props: DarkModeButtonProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/buttons/LanguageButton.d.ts
 interface LanguageButtonProps {
   languages?: string[];
   actionProps?: ActionProps;
 }
-declare const LanguageButton: (props: LanguageButtonProps) => react_jsx_runtime12.JSX.Element;
+declare const LanguageButton: (props: LanguageButtonProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/buttons/OmnibarButton.d.ts
 interface OmnibarButtonProps {
   actionProps?: ActionProps;
   collapsed?: boolean;
 }
-declare const OmnibarButton: (props: OmnibarButtonProps) => react_jsx_runtime12.JSX.Element;
+declare const OmnibarButton: (props: OmnibarButtonProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/buttons/ThemeButton.d.ts
 interface ThemeButtonProps {
   actionProps?: Partial<ActionProps>;
 }
-declare const ThemeButton: (props: ThemeButtonProps) => react_jsx_runtime12.JSX.Element;
+declare const ThemeButton: (props: ThemeButtonProps) => react_jsx_runtime11.JSX.Element;
+//#endregion
+//#region ../../src/core/components/buttons/ToggleSidebarButton.d.ts
+type Props = ActionProps;
+declare const ToggleSidebarButton: (props: Props) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/services/DialogService.d.ts
 interface BaseDialogOptions extends Partial<ModalProps> {
@@ -477,44 +529,44 @@ interface DialogServiceOptions {
 declare class DialogService {
   readonly options: DialogServiceOptions;
   /**
-       * Show an alert dialog with a message
-       */
+   * Show an alert dialog with a message
+   */
   alert(options?: AlertDialogOptions): Promise<void>;
   /**
-       * Show a confirmation dialog that returns a promise
-       */
+   * Show a confirmation dialog that returns a promise
+   */
   confirm(options?: ConfirmDialogOptions): Promise<boolean>;
   /**
-       * Show a prompt dialog to get user input
-       */
+   * Show a prompt dialog to get user input
+   */
   prompt(options?: PromptDialogOptions): Promise<string | null>;
   /**
-       * Open a custom dialog with provided content
-       */
+   * Open a custom dialog with provided content
+   */
   open(options?: BaseDialogOptions): string;
   /**
-       * Close the currently open dialog or a specific dialog by ID
-       */
+   * Close the currently open dialog or a specific dialog by ID
+   */
   close(modalId?: string): void;
   /**
-       * Show an error viewer dialog
-       */
+   * Show an error viewer dialog
+   */
   error(error: Error | unknown, options?: BaseDialogOptions & {
     showStack?: boolean;
   }): void;
   /**
-       * Show a form dialog for structured input
-       */
+   * Show a form dialog for structured input
+   */
   form(options?: BaseDialogOptions): Promise<any>;
   /**
-       * Show a loading/progress dialog with optional progress percentage
-       */
+   * Show a loading/progress dialog with optional progress percentage
+   */
   loading(options?: BaseDialogOptions & {
     progress?: number;
   }): void;
   /**
-       * Show an image viewer/gallery dialog
-       */
+   * Show an image viewer/gallery dialog
+   */
   image(src: string | string[], options?: BaseDialogOptions): void;
 }
 //#endregion
@@ -522,19 +574,19 @@ declare class DialogService {
 declare const AlertDialog: ({
   options,
   onClose
-}: AlertDialogProps) => react_jsx_runtime12.JSX.Element;
+}: AlertDialogProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/dialogs/ConfirmDialog.d.ts
 declare const ConfirmDialog: ({
   options,
   onConfirm
-}: ConfirmDialogProps) => react_jsx_runtime12.JSX.Element;
+}: ConfirmDialogProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/dialogs/PromptDialog.d.ts
 declare const PromptDialog: ({
   options,
   onSubmit
-}: PromptDialogProps) => react_jsx_runtime12.JSX.Element;
+}: PromptDialogProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/form/ControlDate.d.ts
 interface ControlDateProps extends GenericControlProps {
@@ -552,7 +604,7 @@ interface ControlDateProps extends GenericControlProps {
  *
  * Automatically detects date formats from schema and renders appropriate picker.
  */
-declare const ControlDate: (props: ControlDateProps) => react_jsx_runtime12.JSX.Element | null;
+declare const ControlDate: (props: ControlDateProps) => react_jsx_runtime11.JSX.Element | null;
 //#endregion
 //#region ../../src/core/components/form/ControlQueryBuilder.d.ts
 interface ControlQueryBuilderProps extends Omit<TextInputProps, "value" | "onChange"> {
@@ -571,7 +623,7 @@ declare const ControlQueryBuilder: ({
   onChange,
   placeholder,
   ...textInputProps
-}: ControlQueryBuilderProps) => react_jsx_runtime12.JSX.Element;
+}: ControlQueryBuilderProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/form/TypeForm.d.ts
 interface TypeFormProps<T extends TObject> {
@@ -587,13 +639,13 @@ interface TypeFormProps<T extends TObject> {
   schema?: TObject;
   children?: (input: FormModel<T>["input"]) => ReactNode;
   /**
-       * Control props applied to all fields.
-       */
+   * Control props applied to all fields.
+   */
   controlProps?: Partial<Omit<ControlProps, "input">>;
   /**
-       * Per-field control props override.
-       * Keys are field names from the schema.
-       */
+   * Per-field control props override.
+   * Keys are field names from the schema.
+   */
   fieldControlProps?: Record<string, Partial<Omit<ControlProps, "input">>>;
   skipFormElement?: boolean;
   skipSubmitButton?: boolean;
@@ -616,7 +668,7 @@ interface TypeFormProps<T extends TObject> {
  * @example
  * ```tsx
  * import { t } from "alepha";
- * import { useForm } from "@alepha/react/form";
+ * import { useForm } from "alepha/react/form";
  * import { TypeForm } from "@alepha/ui";
  *
  * const form = useForm({
@@ -643,7 +695,7 @@ interface TypeFormProps<T extends TObject> {
  * return <TypeForm form={form} columns={2} />;
  * ```
  */
-declare const TypeForm: <T extends TObject>(props: TypeFormProps<T>) => react_jsx_runtime12.JSX.Element | null;
+declare const TypeForm: <T extends TObject>(props: TypeFormProps<T>) => react_jsx_runtime11.JSX.Element | null;
 //#endregion
 //#region ../../src/core/components/layout/AppBar.d.ts
 type AppBarItem = AppBarElement | AppBarBurger | AppBarDark | AppBarSearch | AppBarLang | AppBarSpacer | AppBarDivider;
@@ -682,7 +734,7 @@ interface AppBarProps {
   flexProps?: FlexProps;
   items?: AppBarItem[];
 }
-declare const AppBar: (props: AppBarProps) => react_jsx_runtime12.JSX.Element;
+declare const AppBar: (props: AppBarProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/layout/Sidebar.d.ts
 interface SidebarProps {
@@ -697,13 +749,13 @@ interface SidebarProps {
     paths?: string[];
   };
   /**
-       * Automatically populate the menu from the router's pages.
-       */
+   * Automatically populate the menu from the router's pages.
+   */
   autoPopulateMenu?: boolean | {
     startsWith: string;
   };
 }
-declare const Sidebar: (props: SidebarProps) => react_jsx_runtime12.JSX.Element;
+declare const Sidebar: (props: SidebarProps) => react_jsx_runtime11.JSX.Element;
 interface SidebarItemProps {
   item: SidebarMenuItem;
   level: number;
@@ -775,26 +827,19 @@ interface AdminShellProps {
   header?: ReactNode;
   footer?: ReactNode;
   children?: ReactNode;
+  /**
+   * Enable drag-to-resize for the sidebar.
+   * Width and constraints are configured in alephaSidebarAtom.
+   */
+  resizable?: boolean;
   noSidebarWhen?: {
     /**
-             * Paths where the sidebar should be hidden.
-             */
+     * Paths where the sidebar should be hidden.
+     */
     paths?: string[];
   };
 }
-declare module "alepha" {
-  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_runtime12.JSX.Element;
+declare const AdminShell: (props: AdminShellProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/layout/Omnibar.d.ts
 interface OmnibarProps {
@@ -802,7 +847,7 @@ interface OmnibarProps {
   searchPlaceholder?: string;
   nothingFound?: ReactNode;
 }
-declare const Omnibar: (props: OmnibarProps) => react_jsx_runtime12.JSX.Element;
+declare const Omnibar: (props: OmnibarProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/layout/AlephaMantineProvider.d.ts
 interface AlephaMantineProviderProps {
@@ -814,7 +859,7 @@ interface AlephaMantineProviderProps {
   modals?: ModalsProviderProps;
   omnibar?: OmnibarProps | false;
 }
-declare const AlephaMantineProvider: (props: AlephaMantineProviderProps) => react_jsx_runtime12.JSX.Element;
+declare const AlephaMantineProvider: (props: AlephaMantineProviderProps) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/components/table/types.d.ts
 interface ColumnVisibility {
@@ -833,13 +878,13 @@ interface DataTableColumn<T extends object, Filters extends TObject> {
   value: (item: T, ctx: DataTableColumnContext<Filters>) => ReactNode;
   fit?: boolean;
   /**
-       * Enable sorting for this column. When true, clicking the header will sort by this column.
-       */
+   * Enable sorting for this column. When true, clicking the header will sort by this column.
+   */
   sortable?: boolean;
   /**
-       * The field name to use for sorting. If not provided, the column key is used.
-       * Follows Alepha sort convention: 'field' for ASC, '-field' for DESC.
-       */
+   * The field name to use for sorting. If not provided, the column key is used.
+   * Follows Alepha sort convention: 'field' for ASC, '-field' for DESC.
+   */
   sortKey?: string;
 }
 type MaybePage<T> = Omit<Page<T>, "page"> & {
@@ -860,16 +905,16 @@ interface CheckboxAction<T extends object> {
 }
 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.
-       */
+   * 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.
-       */
+   * The columns to display in the table. Each column is defined by a key and a DataTableColumn object.
+   */
   columns: {
     [key: string]: DataTableColumn<T, Filters>;
   };
@@ -877,8 +922,8 @@ interface DataTableProps<T extends object, Filters extends TObject> {
   typeFormProps?: Partial<Omit<TypeFormProps<Filters>, "form">>;
   onFilterChange?: (key: string, value: unknown, form: FormModel<Filters>) => void;
   /**
-       * Optional filters to apply to the data.
-       */
+   * Optional filters to apply to the data.
+   */
   filters?: TObject;
   panel?: (item: T) => ReactNode;
   canPanel?: (item: T) => boolean;
@@ -886,57 +931,57 @@ interface DataTableProps<T extends object, Filters extends TObject> {
   submitEvery?: DurationLike;
   withLineNumbers?: boolean;
   /**
-       * Enable row selection with checkboxes. When true, a checkbox column is added as the first column.
-       */
+   * Enable row selection with checkboxes. When true, a checkbox column is added as the first column.
+   */
   withCheckbox?: boolean;
   /**
-       * Function to get a unique key for each item. Required when withCheckbox is true.
-       * Used to track selected items across pagination.
-       */
+   * Function to get a unique key for each item. Required when withCheckbox is true.
+   * Used to track selected items across pagination.
+   */
   getItemKey?: (item: T) => string;
   /**
-       * Actions to display when items are selected. Each action receives the selected items.
-       */
+   * Actions to display when items are selected. Each action receives the selected items.
+   */
   checkboxActions?: Array<CheckboxAction<T>>;
   actions?: Array<ActionProps & {
     label?: ReactNode;
   }>;
   /**
-       * Enable infinity scroll mode. When true, pagination controls are hidden and new items are loaded automatically when scrolling to the bottom.
-       */
+   * Enable infinity scroll mode. When true, pagination controls are hidden and new items are loaded automatically when scrolling to the bottom.
+   */
   infinityScroll?: boolean;
   /**
-       * Initial column visibility state. By default, first 10 columns are visible.
-       */
+   * Initial column visibility state. By default, first 10 columns are visible.
+   */
   defaultColumnVisibility?: ColumnVisibility;
   /**
-       * Maximum number of columns to show by default. Default is 10.
-       */
+   * Maximum number of columns to show by default. Default is 10.
+   */
   defaultVisibleColumnCount?: number;
   /**
-       * Callback when column visibility changes.
-       */
+   * Callback when column visibility changes.
+   */
   onColumnVisibilityChange?: (visibility: ColumnVisibility) => void;
   /**
-       * Initial filter visibility state. By default, all filters are visible.
-       */
+   * Initial filter visibility state. By default, all filters are visible.
+   */
   defaultFilterVisibility?: FilterVisibility;
   /**
-       * Callback when filter visibility changes.
-       */
+   * Callback when filter visibility changes.
+   */
   onFilterVisibilityChange?: (visibility: FilterVisibility) => void;
   /**
-       * Props to pass to the Mantine Table component.
-       */
+   * Props to pass to the Mantine Table component.
+   */
   tableProps?: TableProps;
   /**
-       * Function to generate props for each table row based on the item.
-       */
+   * Function to generate props for each table row based on the item.
+   */
   tableTrProps?: (item: T) => TableTrProps;
 }
 //#endregion
 //#region ../../src/core/components/table/DataTable.d.ts
-declare const DataTable: <T extends object, Filters extends TObject>(props: DataTableProps<T, Filters>) => react_jsx_runtime12.JSX.Element;
+declare const DataTable: <T extends object, Filters extends TObject>(props: DataTableProps<T, Filters>) => react_jsx_runtime11.JSX.Element;
 //#endregion
 //#region ../../src/core/constants/ui.d.ts
 declare const ui: {
@@ -1012,17 +1057,12 @@ declare class ThemeProvider {
   protected readonly cookie: alepha_server_cookies0.AbstractCookiePrimitive<alepha1.TObject<{
     index: alepha1.TInteger;
   }>>;
-  protected readonly head: _alepha_react_head0.HeadPrimitive;
+  protected readonly head: alepha_react_head0.HeadPrimitive;
   setTheme(index: number): void;
   getTheme(): AlephaTheme;
   protected getThemeIndex(): number;
 }
 //#endregion
-//#region ../../src/core/RootRouter.d.ts
-declare class RootRouter {
-  readonly root: _alepha_react_router0.PagePrimitive<_alepha_react_router0.PageConfigSchema, any, _alepha_react_router0.TPropsParentDefault>;
-}
-//#endregion
 //#region ../../src/core/utils/extractSchemaFields.d.ts
 interface SchemaField {
   name: string;
@@ -1091,36 +1131,59 @@ declare module "typebox" {
 }
 declare module "alepha" {
   interface State {
+    [alephaSidebarAtom.key]?: Static<typeof alephaSidebarAtom.schema>;
     [alephaThemeAtom.key]?: Static<typeof alephaThemeAtom.schema>;
   }
 }
-declare module "@alepha/react/router" {
+declare module "alepha/react/router" {
   interface PagePrimitiveOptions {
     /**
-             * Human-readable title for the page.
-             * - for Sidebar navigation
-             * - for Omnibar navigation
-             * (soon)
-             * - for Breadcrumbs
-             * - for document title (with AlephaReactHead)
-             */
+     * 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.
-             */
+     * Optional description of the page.
+     */
     description?: string;
     /**
-             * Optional icon for the page.
-             */
+     * Optional icon for the page.
+     */
     icon?: ReactNode | ComponentType;
   }
 }
 /**
- * Mantine
+ * | type | quality | stability |
+ * |------|---------|-----------|
+ * | frontend | rare | experimental |
+ *
+ * Core UI components based on Mantine UI v8.
+ *
+ * **Features:**
+ * - Mantine integration with theme support
+ * - ActionButton, BurgerButton, ClipboardButton, DarkModeButton, LanguageButton, ThemeButton
+ * - AlertDialog, ConfirmDialog, PromptDialog
+ * - Form controls: Control, ControlArray, ControlDate, ControlNumber, ControlObject, ControlSelect, ControlQueryBuilder
+ * - TypeForm for automatic form generation from TypeBox schemas
+ * - AdminShell layout component
+ * - AppBar with configurable elements
+ * - Sidebar navigation with sections and menu items
+ * - Omnibar for command palette / search
+ * - DataTable with filtering, sorting, pagination
+ * - Toast notifications
+ * - Theme system with dark mode
  *
  * @module alepha.ui
  */
 declare const AlephaUI: alepha1.Service<alepha1.Module>;
+/**
+ * Register UI components and get the RootRouter instance.
+ */
+declare const $ui: (opts?: {}) => RootRouter;
 //#endregion
-export { ActionButton, type ActionClickButtonProps, type ActionCommonProps, type ActionMenuConfig, type ActionMenuItem, type ActionNavigationButtonProps, type ActionProps, type ActionSubmitButtonProps, AdminShell, type AdminShellProps, 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, BurgerButton, type CheckboxAction, type CheckboxActionContext, ClipboardButton, type ClipboardButtonProps, type ColumnVisibility, ConfirmDialog, type ConfirmDialogOptions, type ConfirmDialogProps, Control, ControlArray, ControlDate, ControlNumber, ControlObject, ControlQueryBuilder, ControlSelect, CurrentAlephaTheme, DarkModeButton, DataTable, type DataTableColumn, type DataTableColumnContext, type DataTableProps, type DataTableSubmitContext, DialogService, type FilterVisibility, Flex, IconSize, LanguageButton, type MaybePage, 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, ThemeButton, type ThemeButtonProps, ThemeProvider, ToastService, TypeForm, alephaThemeAtom, alephaThemeListAtom, capitalize, defaultTheme, extractSchemaFields, getDefaultIcon, getOperatorsForField, midnightTheme, prettyName, ui, useDialog, useToast };
+export { $ui, ActionButton, type ActionClickButtonProps, type ActionCommonProps, type ActionMenuConfig, type ActionMenuItem, type ActionNavigationButtonProps, type ActionProps, type ActionSubmitButtonProps, AdminShell, type AdminShellProps, AlephaMantineProvider, AlephaSidebarState, 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, BurgerButton, type CheckboxAction, type CheckboxActionContext, ClipboardButton, type ClipboardButtonProps, type ColumnVisibility, ConfirmDialog, type ConfirmDialogOptions, type ConfirmDialogProps, Control, ControlArray, ControlDate, ControlNumber, ControlObject, ControlQueryBuilder, ControlSelect, CurrentAlephaTheme, DarkModeButton, DataTable, type DataTableColumn, type DataTableColumnContext, type DataTableProps, type DataTableSubmitContext, DialogService, type FilterVisibility, Flex, IconSize, LanguageButton, type MaybePage, 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, ThemeButton, type ThemeButtonProps, ThemeProvider, ToastService, ToggleSidebarButton, TypeForm, alephaSidebarAtom, alephaThemeAtom, alephaThemeListAtom, capitalize, defaultTheme, extractSchemaFields, getDefaultIcon, getOperatorsForField, midnightTheme, prettyName, ui, useDialog, useToast };
 //# sourceMappingURL=index.d.ts.map