alepha 0.11.5 → 0.11.6

package/ui.d.ts

@@ -1,16 +1,17 @@
 import * as _alepha_core0 from "alepha";
-import { Async, TObject } from "alepha";
+import { Async, Page, PageMetadata, TObject, TProperties } from "alepha";
 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 { AppShellFooterProps, AppShellHeaderProps, AppShellMainProps, AppShellNavbarProps, AppShellProps, AutocompleteProps, ButtonProps, ColorInputProps, ColorSchemeScriptProps, FileInputProps, Flex, FlexProps, MantineBreakpoint, MantineProviderProps, MenuProps, MenuTargetProps, ModalProps, MultiSelectProps, NumberInputProps, PasswordInputProps, SegmentedControlProps, SelectProps, SwitchProps, TableProps, TableTrProps, TagsInputProps, Text, TextInputProps, TextareaProps, ThemeIconProps, TooltipProps } from "@mantine/core";
-import * as react_jsx_runtime9 from "react/jsx-runtime";
+import { AppShellFooterProps, AppShellHeaderProps, AppShellMainProps, AppShellNavbarProps, AppShellProps, AutocompleteProps, ButtonProps, ColorInputProps, ColorSchemeScriptProps, FileInputProps, Flex, FlexProps, MantineBreakpoint, MantineProviderProps, MenuProps, MenuTargetProps, ModalProps, MultiSelectProps, NumberInputProps, PasswordInputProps, SegmentedControlProps, SelectProps, SliderProps, SwitchProps, TableProps, TableTrProps, TagsInputProps, Text, TextInputProps, TextareaProps, ThemeIconProps, TooltipProps } from "@mantine/core";
+import * as react_jsx_runtime5 from "react/jsx-runtime";
 import { ComponentType, ReactNode } from "react";
 import * as _mantine_notifications0 from "@mantine/notifications";
 import { NotificationData, NotificationsProps } from "@mantine/notifications";
 import { DateInputProps, DateTimePickerProps, TimeInputProps } from "@mantine/dates";
 import { NavigationProgressProps } from "@mantine/nprogress";
+import { DurationLike } from "alepha/datetime";
 
 //#region src/utils/parseInput.d.ts
 interface GenericControlProps {
@@ -20,6 +21,12 @@ interface GenericControlProps {
   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;
@@ -47,7 +54,7 @@ interface ControlSelectProps extends GenericControlProps {
  *
  * Automatically detects enum values and array types from schema.
  */
-declare const ControlSelect: (props: ControlSelectProps) => react_jsx_runtime9.JSX.Element | null;
+declare const ControlSelect: (props: ControlSelectProps) => react_jsx_runtime5.JSX.Element | null;
 //#endregion
 //#region src/components/form/Control.d.ts
 interface ControlProps extends GenericControlProps {
@@ -56,12 +63,13 @@ interface ControlProps extends GenericControlProps {
   select?: boolean | Partial<ControlSelectProps>;
   password?: boolean | PasswordInputProps;
   switch?: boolean | SwitchProps;
-  number?: boolean | NumberInputProps;
+  number?: boolean | Partial<ControlNumberProps>;
   file?: boolean | FileInputProps;
   color?: boolean | ColorInputProps;
   date?: boolean | DateInputProps;
   datetime?: boolean | DateTimePickerProps;
   time?: boolean | TimeInputProps;
+  query?: any;
   custom?: ComponentType<CustomControlProps>;
 }
 /**
@@ -81,11 +89,12 @@ interface ControlProps extends GenericControlProps {
  * - 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_runtime9.JSX.Element | null;
+declare const Control: (_props: ControlProps) => react_jsx_runtime5.JSX.Element | null;
 type CustomControlProps = {
   defaultValue: any;
   onChange: (value: any) => void;
@@ -180,9 +189,10 @@ interface ActionCommonProps extends ButtonProps {
   themeIconProps?: ThemeIconProps;
 }
 type ActionProps = ActionCommonProps & (ActionNavigationButtonProps | ActionClickButtonProps | ActionSubmitButtonProps | ActionHookButtonProps | {});
-declare const ActionButton: (_props: ActionProps) => react_jsx_runtime9.JSX.Element;
+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>;
@@ -208,14 +218,14 @@ interface DarkModeButtonProps {
   segmentedProps?: Partial<SegmentedControlProps>;
   actionProps?: Partial<ActionProps>;
 }
-declare const DarkModeButton: (props: DarkModeButtonProps) => react_jsx_runtime9.JSX.Element;
+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_runtime9.JSX.Element;
+declare const OmnibarButton: (props: OmnibarButtonProps) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/services/DialogService.d.ts
 interface BaseDialogOptions extends Partial<ModalProps> {
@@ -300,19 +310,19 @@ declare class DialogService {
 declare const AlertDialog: ({
   options,
   onClose
-}: AlertDialogProps) => react_jsx_runtime9.JSX.Element;
+}: AlertDialogProps) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/dialogs/ConfirmDialog.d.ts
 declare const ConfirmDialog: ({
   options,
   onConfirm
-}: ConfirmDialogProps) => react_jsx_runtime9.JSX.Element;
+}: ConfirmDialogProps) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/dialogs/PromptDialog.d.ts
 declare const PromptDialog: ({
   options,
   onSubmit
-}: PromptDialogProps) => react_jsx_runtime9.JSX.Element;
+}: PromptDialogProps) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/form/ControlDate.d.ts
 interface ControlDateProps extends GenericControlProps {
@@ -330,7 +340,26 @@ interface ControlDateProps extends GenericControlProps {
  *
  * Automatically detects date formats from schema and renders appropriate picker.
  */
-declare const ControlDate: (props: ControlDateProps) => react_jsx_runtime9.JSX.Element | null;
+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> {
@@ -343,6 +372,7 @@ interface TypeFormProps<T extends TObject> {
     lg?: number;
     xl?: number;
   };
+  schema?: TObject;
   children?: (input: FormModel<T>["input"]) => ReactNode;
   controlProps?: Partial<Omit<ControlProps, "input">>;
   skipFormElement?: boolean;
@@ -375,7 +405,7 @@ interface TypeFormProps<T extends TObject> {
  * return <TypeForm form={form} columns={2} />;
  * ```
  */
-declare const TypeForm: <T extends TObject>(props: TypeFormProps<T>) => react_jsx_runtime9.JSX.Element | null;
+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 {
@@ -420,7 +450,7 @@ interface AppBarProps {
   flexProps?: FlexProps;
   items?: AppBarItem[];
 }
-declare const AppBar: (props: AppBarProps) => react_jsx_runtime9.JSX.Element;
+declare const AppBar: (props: AppBarProps) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/layout/Sidebar.d.ts
 interface SidebarProps {
@@ -434,7 +464,7 @@ interface SidebarProps {
   collapsed?: boolean;
   gap?: MantineBreakpoint;
 }
-declare const Sidebar: (props: SidebarProps) => react_jsx_runtime9.JSX.Element;
+declare const Sidebar: (props: SidebarProps) => react_jsx_runtime5.JSX.Element;
 interface SidebarItemProps {
   item: SidebarMenuItem;
   level: number;
@@ -466,12 +496,14 @@ interface SidebarSearch extends SidebarAbstractItem {
 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[];
@@ -503,11 +535,17 @@ interface AdminShellProps {
 }
 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_runtime9.JSX.Element;
+declare const AdminShell: (props: AdminShellProps) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/layout/Omnibar.d.ts
 interface OmnibarProps {
@@ -515,7 +553,7 @@ interface OmnibarProps {
   searchPlaceholder?: string;
   nothingFound?: ReactNode;
 }
-declare const Omnibar: (props: OmnibarProps) => react_jsx_runtime9.JSX.Element;
+declare const Omnibar: (props: OmnibarProps) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/layout/AlephaMantineProvider.d.ts
 interface AlephaMantineProviderProps {
@@ -527,22 +565,58 @@ interface AlephaMantineProviderProps {
   modals?: ModalsProviderProps;
   omnibar?: OmnibarProps;
 }
-declare const AlephaMantineProvider: (props: AlephaMantineProviderProps) => react_jsx_runtime9.JSX.Element;
+declare const AlephaMantineProvider: (props: AlephaMantineProviderProps) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/components/table/DataTable.d.ts
 interface DataTableColumn<T extends object> {
   label: string;
-  value: (item: T) => ReactNode;
+  value: (item: T, index: number) => ReactNode;
 }
+type MaybePage<T> = Omit<Page<T>, "page"> & {
+  page?: Partial<PageMetadata>;
+};
 interface DataTableProps<T extends object> {
-  items: T[] | (() => Async<T[]>);
+  /**
+   * 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: Record<string, string> & {
+    page: number;
+    size: number;
+    sort?: string;
+  }) => 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>;
   };
+  defaultSize?: number;
+  /**
+   * 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>(props: DataTableProps<T>) => react_jsx_runtime9.JSX.Element;
+declare const DataTable: <T extends object>(props: DataTableProps<T>) => react_jsx_runtime5.JSX.Element;
 //#endregion
 //#region src/constants/ui.d.ts
 declare const ui: {
@@ -551,6 +625,7 @@ declare const ui: {
     background: string;
     surface: string;
     elevated: string;
+    border: string;
   };
 };
 //#endregion
@@ -603,6 +678,34 @@ 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
@@ -677,7 +780,7 @@ declare module "alepha/react" {
  *
  * @module alepha.ui
  */
-declare const AlephaUI: _alepha_core0.Service<_alepha_core0.Module<{}>>;
+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, ControlSelect, DarkModeButton, DataTable, type DataTableColumn, type DataTableProps, DialogService, Flex, ICON_SIZES, IconSize, Omnibar, OmnibarButton, PromptDialog, type PromptDialogOptions, type PromptDialogProps, RootRouter, 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, getDefaultIcon, prettyName, ui, useDialog, useToast };
+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, 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.ts.map