alepha 0.11.5 → 0.11.7

package/ui.d.ts

@@ -1,16 +1,17 @@
 import * as _alepha_core0 from "alepha";
-import { Async, TObject } from "alepha";
+import { Alepha, Async, Page, PageMetadata, Static, 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 { 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 { 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 { ComponentType, ReactNode } from "react";
+import * as react_jsx_runtime9 from "react/jsx-runtime";
 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;
@@ -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,6 +89,7 @@ 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.
@@ -183,6 +192,7 @@ type ActionProps = ActionCommonProps & (ActionNavigationButtonProps | ActionClic
 declare const ActionButton: (_props: ActionProps) => react_jsx_runtime9.JSX.Element;
 interface ActionSubmitButtonProps extends ButtonProps {
   form: FormModel<any>;
+  type?: "submit" | "reset";
 }
 interface ActionHookButtonProps extends ButtonProps {
   action: UseActionReturn<any[], any>;
@@ -217,6 +227,22 @@ interface OmnibarButtonProps {
 }
 declare const OmnibarButton: (props: OmnibarButtonProps) => react_jsx_runtime9.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_runtime9.JSX.Element;
+//#endregion
 //#region src/services/DialogService.d.ts
 interface BaseDialogOptions extends Partial<ModalProps> {
   title?: ReactNode;
@@ -332,6 +358,25 @@ interface ControlDateProps extends GenericControlProps {
  */
 declare const ControlDate: (props: ControlDateProps) => react_jsx_runtime9.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_runtime9.JSX.Element;
+//#endregion
 //#region src/components/form/TypeForm.d.ts
 interface TypeFormProps<T extends TObject> {
   form: FormModel<T>;
@@ -343,6 +388,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;
@@ -466,12 +512,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,7 +551,13 @@ 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;
   }
 }
@@ -530,19 +584,66 @@ interface AlephaMantineProviderProps {
 declare const AlephaMantineProvider: (props: AlephaMantineProviderProps) => react_jsx_runtime9.JSX.Element;
 //#endregion
 //#region src/components/table/DataTable.d.ts
-interface DataTableColumn<T extends object> {
+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) => ReactNode;
+  value: (item: T, ctx: DataTableColumnContext<Filters>) => ReactNode;
+  fit?: boolean;
 }
-interface DataTableProps<T extends object> {
-  items: T[] | (() => Async<T[]>);
+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>;
+    [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>(props: DataTableProps<T>) => react_jsx_runtime9.JSX.Element;
+declare const DataTable: <T extends object, Filters extends TObject>(props: DataTableProps<T, Filters>) => react_jsx_runtime9.JSX.Element;
 //#endregion
 //#region src/constants/ui.d.ts
 declare const ui: {
@@ -551,6 +652,7 @@ declare const ui: {
     background: string;
     surface: string;
     elevated: string;
+    border: string;
   };
 };
 //#endregion
@@ -603,6 +705,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 +807,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, 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.ts.map

package/vite.d.ts

@@ -126,7 +126,7 @@ interface ViteAlephaBuildOptions {
    * Path to the entry file for the server build.
    * If empty, SSR build will be skipped.
    */
-  serverEntry?: string;
+  serverEntry?: string | false;
   /**
    * Set false to skip the client build.
    * This is useful if you only want to build the server-side application.
@@ -158,7 +158,7 @@ interface ViteAlephaDevOptions {
    * Path to the entry file for the server build.
    * If empty, plugin will be disabled.
    */
-  serverEntry?: string;
+  serverEntry?: string | false;
   /**
    * If true, enables debug logging.
    *