@vef-framework-react/starter 2.1.3 → 2.1.5

package/dist/types/components/crud-page/props.d.ts

@@ -1,57 +0,0 @@
-import { ReactNode } from 'react';
-import { CrudProps } from '../crud';
-import { AsideWidth, Position } from '../page';
-/**
- * Props for the CrudPage component, supporting both paginated and non-paginated modes.
- *
- * @template TRow - Table row model type
- * @template TSearchValues - Search/filters form values type
- * @template TSceneFormValues - A map of scene key to its form values type
- * @template TParams - Additional query parameters type
- */
-export type CrudPageProps<TRow extends object, TSearchValues extends object, TSceneFormValues extends Record<string, object>, TParams extends object = never> = CrudProps<TRow, TSearchValues, TSceneFormValues, TParams> & {
-    /**
-     * The left aside content of the page
-     */
-    leftAside?: ReactNode;
-    /**
-     * The width of the left aside
-     */
-    leftAsideWidth?: AsideWidth;
-    /**
-     * The right aside content of the page
-     */
-    rightAside?: ReactNode;
-    /**
-     * The width of the right aside
-     */
-    rightAsideWidth?: AsideWidth;
-    /**
-     * The header of the page
-     */
-    header?: ReactNode;
-    /**
-     * The class name of the header
-     */
-    headerClassName?: string;
-    /**
-     * The position of the header
-     *
-     * @default "inside"
-     */
-    headerPosition?: Position;
-    /**
-     * The footer of the page
-     */
-    footer?: ReactNode;
-    /**
-     * The class name of the footer
-     */
-    footerClassName?: string;
-    /**
-     * The position of the footer
-     *
-     * @default "inside"
-     */
-    footerPosition?: Position;
-};

package/dist/types/components/flex-card/index.d.ts

@@ -1,3 +0,0 @@
-import { FlexCardProps } from './props.js';
-export declare function FlexCard({ variant, ...props }: FlexCardProps): React.ReactElement;
-export type { FlexCardProps } from './props.js';

package/dist/types/components/flex-card/props.d.ts

@@ -1,2 +0,0 @@
-import { CardProps } from '@vef-framework-react/components';
-export type FlexCardProps = CardProps;

package/dist/types/components/flex-card/styles.d.ts

@@ -1,2 +0,0 @@
-import { SerializedStyles } from '@emotion/serialize';
-export declare const container: SerializedStyles;

package/dist/types/components/form-drawer/components/form-actions.d.ts

@@ -1,19 +0,0 @@
-import { ReactNode, MemoExoticComponent } from 'react';
-import { FormDrawerProps } from '../props';
-interface FormActionsProps {
-    /**
-     * Submit button props
-     */
-    submitButtonProps?: FormDrawerProps<never>["submitButtonProps"];
-    /**
-     * Reset button props, or false to hide the reset button
-     */
-    resetButtonProps?: FormDrawerProps<never>["resetButtonProps"];
-    /**
-     * Callback when reset is triggered
-     */
-    onReset?: () => void;
-}
-declare function FormActionsBase({ submitButtonProps, resetButtonProps, onReset }: FormActionsProps): ReactNode;
-export declare const FormActions: MemoExoticComponent<typeof FormActionsBase>;
-export {};

package/dist/types/components/form-drawer/components/index.d.ts

@@ -1 +0,0 @@
-export { FormActions } from './form-actions';

package/dist/types/components/form-drawer/index.d.ts

@@ -1,5 +0,0 @@
-import { Awaitable } from '@vef-framework-react/shared';
-import { FC, ReactNode } from 'react';
-import { FormDrawerProps } from './props';
-export declare const FormDrawer: (<TValues extends object, TData = unknown>(props: FormDrawerProps<TValues, TData>) => Awaitable<ReactNode>) & Pick<FC, "displayName">;
-export type { FormDrawerProps } from './props';

package/dist/types/components/form-drawer/props.d.ts

@@ -1,78 +0,0 @@
-import { DrawerProps, FormApi, Length, ResetButtonProps, SubmitButtonProps } from '@vef-framework-react/components';
-import { ApiResult, MutationFunction, MutationMeta } from '@vef-framework-react/core';
-import { Awaitable, Except } from '@vef-framework-react/shared';
-import { ReactNode } from 'react';
-/**
- * Props for the FormDrawer component
- *
- * @template TValues - The type of the form values
- * @template TData - The type of the mutation response data
- */
-export interface FormDrawerProps<TValues extends object, TData = unknown> extends Pick<DrawerProps, "title" | "placement" | "resizable"> {
-    /**
-     * Whether the form drawer is visible
-     *
-     * @default false
-     */
-    open?: boolean;
-    /**
-     * Width of the form drawer
-     */
-    width?: Length;
-    /**
-     * Default form values
-     */
-    defaultValues?: TValues;
-    /**
-     * Whether to disable the form
-     *
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * Custom render function for footer actions
-     * Return null to hide the footer entirely
-     * If not provided, will render default submit and reset buttons
-     */
-    renderActions?: (formApi: FormApi<TValues>) => ReactNode;
-    /**
-     * Submit button props (only used when renderActions is not provided)
-     */
-    submitButtonProps?: Except<SubmitButtonProps, "onSubmit" | "disabled" | "loading">;
-    /**
-     * Reset button props, or false to hide the reset button (only used when renderActions is not provided)
-     */
-    resetButtonProps?: Except<ResetButtonProps, "onReset" | "disabled" | "loading"> | false;
-    /**
-     * Mutation function to execute on submit
-     */
-    mutationFn?: MutationFunction<ApiResult<TData>, TValues>;
-    /**
-     * Mutation metadata
-     */
-    mutationMeta?: MutationMeta;
-    /**
-     * Form content, can be a ReactNode or a function that receives form API
-     */
-    children?: ReactNode | ((formApi: FormApi<TValues>) => ReactNode);
-    /**
-     * Callback before form submission
-     */
-    beforeSubmit?: (values: TValues) => Awaitable<TValues>;
-    /**
-     * Callback after successful submission
-     */
-    afterSubmit?: (values: TValues, data: TData) => Awaitable<void>;
-    /**
-     * Callback on form submit
-     */
-    onSubmit?: (values: TValues) => Awaitable<void>;
-    /**
-     * Callback on form reset
-     */
-    onReset?: (defaultValues?: TValues) => void;
-    /**
-     * Callback when drawer is closed
-     */
-    onClose?: () => void;
-}

package/dist/types/components/form-modal/components/draggable-wrapper.d.ts

@@ -1,9 +0,0 @@
-import { ModalProps } from '@vef-framework-react/components';
-import { ReactElement, ReactNode, MemoExoticComponent } from 'react';
-interface DraggableWrapperProps {
-    title: ReactNode;
-    children: ReactElement<ModalProps>;
-}
-declare function DraggableWrapperBase({ title, children }: DraggableWrapperProps): ReactElement;
-export declare const DraggableWrapper: MemoExoticComponent<typeof DraggableWrapperBase>;
-export {};

package/dist/types/components/form-modal/components/form-actions.d.ts

@@ -1,19 +0,0 @@
-import { ReactNode, MemoExoticComponent } from 'react';
-import { FormModalProps } from '../props';
-interface FormActionsProps {
-    /**
-     * Submit button props
-     */
-    submitButtonProps?: FormModalProps<never>["submitButtonProps"];
-    /**
-     * Reset button props, or false to hide the reset button
-     */
-    resetButtonProps?: FormModalProps<never>["resetButtonProps"];
-    /**
-     * Callback when reset is triggered
-     */
-    onReset?: () => void;
-}
-declare function FormActionsBase({ submitButtonProps, resetButtonProps, onReset }: FormActionsProps): ReactNode;
-export declare const FormActions: MemoExoticComponent<typeof FormActionsBase>;
-export {};

package/dist/types/components/form-modal/components/index.d.ts

@@ -1,2 +0,0 @@
-export { DraggableWrapper } from './draggable-wrapper';
-export { FormActions } from './form-actions';

package/dist/types/components/form-modal/index.d.ts

@@ -1,5 +0,0 @@
-import { Awaitable } from '@vef-framework-react/shared';
-import { FC, ReactNode } from 'react';
-import { FormModalProps } from './props';
-export declare const FormModal: (<TValues extends object, TData = unknown>(props: FormModalProps<TValues, TData>) => Awaitable<ReactNode>) & Pick<FC, "displayName">;
-export type { FormModalProps } from './props';

package/dist/types/components/form-modal/props.d.ts

@@ -1,80 +0,0 @@
-import { FormApi, ModalProps, ResetButtonProps, SubmitButtonProps } from '@vef-framework-react/components';
-import { ApiResult, MutationFunction, MutationMeta } from '@vef-framework-react/core';
-import { Awaitable, Except } from '@vef-framework-react/shared';
-import { ReactNode } from 'react';
-/**
- * Props for the FormModal component
- *
- * @template TValues - The type of the form values
- * @template TData - The type of the mutation response data
- */
-export interface FormModalProps<TValues extends object, TData = unknown> extends Pick<ModalProps, "title" | "width"> {
-    /**
-     * Whether the form modal is visible
-     *
-     * @default false
-     */
-    open?: boolean;
-    /**
-     * Whether the modal can be dragged by its header
-     *
-     * @default true
-     */
-    draggable?: boolean;
-    /**
-     * Default form values
-     */
-    defaultValues?: TValues;
-    /**
-     * Whether to disable the form
-     *
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * Custom render function for footer actions
-     * Return null to hide the footer entirely
-     * If not provided, will render default submit and reset buttons
-     */
-    renderActions?: (formApi: FormApi<TValues>) => ReactNode;
-    /**
-     * Submit button props (only used when renderActions is not provided)
-     */
-    submitButtonProps?: Except<SubmitButtonProps, "onSubmit" | "disabled" | "loading">;
-    /**
-     * Reset button props, or false to hide the reset button (only used when renderActions is not provided)
-     */
-    resetButtonProps?: Except<ResetButtonProps, "onReset" | "disabled" | "loading"> | false;
-    /**
-     * Mutation function to execute on submit
-     */
-    mutationFn?: MutationFunction<ApiResult<TData>, TValues>;
-    /**
-     * Mutation metadata
-     */
-    mutationMeta?: MutationMeta;
-    /**
-     * Form content, can be a ReactNode or a function that receives form API
-     */
-    children?: ReactNode | ((formApi: FormApi<TValues>) => ReactNode);
-    /**
-     * Callback before form submission
-     */
-    beforeSubmit?: (values: TValues) => Awaitable<TValues>;
-    /**
-     * Callback after successful submission
-     */
-    afterSubmit?: (values: TValues, data: TData) => Awaitable<void>;
-    /**
-     * Callback on form submit
-     */
-    onSubmit?: (values: TValues) => Awaitable<void>;
-    /**
-     * Callback on form reset
-     */
-    onReset?: (defaultValues?: TValues) => void;
-    /**
-     * Callback when modal is closed
-     */
-    onClose?: () => void;
-}

package/dist/types/components/logo-icon/index.d.ts

@@ -1,3 +0,0 @@
-import { LogoIconProps } from './props.js';
-export declare function LogoIcon({ primaryColor, ...props }: LogoIconProps): React.ReactElement;
-export type { LogoIconProps } from './props.js';

package/dist/types/components/logo-icon/props.d.ts

@@ -1,4 +0,0 @@
-import { SVGProps } from 'react';
-export interface LogoIconProps extends SVGProps<SVGSVGElement> {
-    primaryColor?: string;
-}

package/dist/types/components/page/components/aside-panel.d.ts

@@ -1,11 +0,0 @@
-import { SerializedStyles } from '@emotion/react';
-import { ReactNode } from 'react';
-import { AsideWidth } from '../props';
-export interface AsidePanelProps {
-    children: ReactNode;
-    className?: string;
-    containerStyle: SerializedStyles;
-    position: "left" | "right";
-    width?: AsideWidth;
-}
-export declare function AsidePanel({ children, className, containerStyle, position, width }: AsidePanelProps): import("@emotion/react/jsx-runtime").JSX.Element;

package/dist/types/components/page/components/index.d.ts

@@ -1,3 +0,0 @@
-export { AsidePanel } from './aside-panel';
-export { ResizeHandle } from './resize-handle';
-export { ScrollContent } from './scroll-content';

package/dist/types/components/page/components/resize-handle.d.ts

@@ -1,7 +0,0 @@
-import { MouseEvent, default as React } from 'react';
-export interface ResizeHandleProps {
-    isDragging: boolean;
-    position: "left" | "right";
-    onMouseDown: (event: MouseEvent) => void;
-}
-export declare function ResizeHandle({ isDragging, position, onMouseDown }: ResizeHandleProps): React.JSX.Element;

package/dist/types/components/page/components/scroll-content.d.ts

@@ -1,8 +0,0 @@
-import { PropsWithChildren, ReactNode } from 'react';
-interface ScrollContentProps extends PropsWithChildren {
-    className?: string;
-    actionBar?: ReactNode;
-    actionBarClassName?: string;
-}
-export declare function ScrollContent({ className, actionBar, actionBarClassName, children }: ScrollContentProps): React.JSX.Element;
-export {};

package/dist/types/components/page/hooks/index.d.ts

@@ -1,2 +0,0 @@
-export { usePageKey } from './use-page-key';
-export { useResize } from './use-resize';

package/dist/types/components/page/hooks/use-page-key.d.ts

@@ -1 +0,0 @@
-export declare function usePageKey(): number;

package/dist/types/components/page/hooks/use-resize.d.ts

@@ -1,15 +0,0 @@
-import { MouseEvent as ReactMouseEvent } from 'react';
-export interface UseResizeOptions {
-    defaultWidth: number;
-    minWidth?: number;
-    maxWidth?: number;
-    /**
-     * true for left panel (drag right to increase), false for right panel (drag left to increase)
-     */
-    isLeftPanel?: boolean;
-}
-export declare function useResize(options: UseResizeOptions): {
-    width: number;
-    isDragging: boolean;
-    handleMouseDown: (event: ReactMouseEvent) => void;
-};

package/dist/types/components/page/index.d.ts

@@ -1,4 +0,0 @@
-import { PageProps } from './props';
-export declare function Page({ className, mainClassName, leftAside, leftAsideClassName, leftAsideWidth, rightAside, rightAsideClassName, rightAsideWidth, header, headerClassName, headerPosition, footer, footerClassName, footerPosition, actionBar, actionBarClassName, scrollable, scrollMargin, margin, gap, children }: PageProps): import("@emotion/react/jsx-runtime").JSX.Element;
-export { type AsideWidth, type PageProps, type Position, type ResizableWidth } from './props';
-export { useViewportHeight } from './viewport-context';

package/dist/types/components/page/props.d.ts

@@ -1,140 +0,0 @@
-import { Length } from '@vef-framework-react/components';
-import { PropsWithChildren, ReactNode } from 'react';
-/**
- * Position type for header and footer.
- * - `"inside"`: Inside the main content area
- * - `"outside"`: Spans the full width of the page (including asides)
- */
-export type Position = "inside" | "outside";
-/**
- * Resizable width configuration for aside panels.
- */
-export interface ResizableWidth {
-    /**
-     * Default width of the panel.
-     */
-    defaultWidth?: Length;
-    /**
-     * Minimum width constraint.
-     */
-    minWidth?: Length;
-    /**
-     * Maximum width constraint.
-     */
-    maxWidth?: Length;
-}
-/**
- * Width type: fixed value or resizable configuration.
- * - `string | number`: Fixed width, not resizable
- * - `ResizableWidth`: Resizable with optional constraints
- */
-export type AsideWidth = Length | ResizableWidth;
-/**
- * The props of the Page component.
- */
-export interface PageProps extends PropsWithChildren {
-    /**
-     * The class name of the page container.
-     */
-    className?: string;
-    /**
-     * Whether the page container has margin.
-     * When true, applies var(--vef-spacing-md) margin to the container.
-     *
-     * @default false
-     */
-    margin?: boolean;
-    /**
-     * The gap between grid cells.
-     *
-     * @default "var(--vef-spacing-md)"
-     */
-    gap?: Length;
-    /**
-     * The class name of the main content area.
-     */
-    mainClassName?: string;
-    /**
-     * The left aside content of the page.
-     */
-    leftAside?: ReactNode;
-    /**
-     * The class name of the left aside.
-     */
-    leftAsideClassName?: string;
-    /**
-     * The width of the left aside.
-     * - `number | string`: Fixed width
-     * - `{ defaultWidth?, minWidth?, maxWidth? }`: Resizable with constraints
-     *
-     * @default 280
-     */
-    leftAsideWidth?: AsideWidth;
-    /**
-     * The right aside content of the page.
-     */
-    rightAside?: ReactNode;
-    /**
-     * The class name of the right aside.
-     */
-    rightAsideClassName?: string;
-    /**
-     * The width of the right aside.
-     * - `number | string`: Fixed width
-     * - `{ defaultWidth?, minWidth?, maxWidth? }`: Resizable with constraints
-     *
-     * @default 280
-     */
-    rightAsideWidth?: AsideWidth;
-    /**
-     * The header of the page.
-     */
-    header?: ReactNode;
-    /**
-     * The class name of the header.
-     */
-    headerClassName?: string;
-    /**
-     * The position of the header.
-     * - `"inside"`: Header is inside the main content area (default)
-     * - `"outside"`: Header spans the full width of the page (including asides)
-     *
-     * @default "inside"
-     */
-    headerPosition?: Position;
-    /**
-     * The footer of the page.
-     */
-    footer?: ReactNode;
-    /**
-     * The class name of the footer.
-     */
-    footerClassName?: string;
-    /**
-     * The position of the footer.
-     * - `"inside"`: Footer is inside the main content area (default)
-     * - `"outside"`: Footer spans the full width of the page (including asides)
-     *
-     * @default "inside"
-     */
-    footerPosition?: Position;
-    /**
-     * The action bar of the page.
-     */
-    actionBar?: ReactNode;
-    /**
-     * The class name of the action bar.
-     */
-    actionBarClassName?: string;
-    /**
-     * Whether the page main content is scrollable.
-     */
-    scrollable?: boolean;
-    /**
-     * Whether the scrollable content has automatic margin for scrollbar spacing.
-     * Only effective when scrollable is true.
-     *
-     * @default false
-     */
-    scrollMargin?: boolean;
-}

package/dist/types/components/page/styles.d.ts

@@ -1,17 +0,0 @@
-import { SerializedStyles } from '@emotion/serialize';
-export declare const page: SerializedStyles;
-export declare const leftAside: SerializedStyles;
-export declare const rightAside: SerializedStyles;
-export declare const asideContent: SerializedStyles;
-export declare const resizeHandleGrip: SerializedStyles;
-export declare const resizeHandleLeft: SerializedStyles;
-export declare const resizeHandleRight: SerializedStyles;
-export declare const main: SerializedStyles;
-export declare const header: SerializedStyles;
-export declare const headerOutside: SerializedStyles;
-export declare const content: SerializedStyles;
-export declare const scrollWrapper: SerializedStyles;
-export declare const scrollContainer: SerializedStyles;
-export declare const footer: SerializedStyles;
-export declare const footerOutside: SerializedStyles;
-export declare const actionBar: SerializedStyles;

package/dist/types/components/page/viewport-context.d.ts

@@ -1,7 +0,0 @@
-import { Provider } from 'react';
-/**
- * Hook to get the viewport height from Page component.
- * Must be used within Page component with scrollable prop set to true.
- */
-export declare function useViewportHeight(): number;
-export declare const ViewportProvider: Provider<number | null>;

package/dist/types/components/pro-search/components/advanced-search-toggler.d.ts

@@ -1,7 +0,0 @@
-import { MemoExoticComponent } from 'react';
-interface AdvancedSearchTogglerProps {
-    isVisible: boolean;
-    onToggle: () => void;
-}
-export declare const AdvancedSearchToggler: MemoExoticComponent<({ isVisible, onToggle }: AdvancedSearchTogglerProps) => import("@emotion/react/jsx-runtime").JSX.Element>;
-export {};

package/dist/types/components/pro-search/components/advanced-search.d.ts

@@ -1,6 +0,0 @@
-import { PropsWithChildren, MemoExoticComponent } from 'react';
-interface AdvancedSearchProps {
-    isVisible: boolean;
-}
-export declare const AdvancedSearch: MemoExoticComponent<({ children, isVisible }: PropsWithChildren<AdvancedSearchProps>) => import("@emotion/react/jsx-runtime").JSX.Element>;
-export {};

package/dist/types/components/pro-search/components/index.d.ts

@@ -1,3 +0,0 @@
-export { AdvancedSearch } from './advanced-search';
-export { AdvancedSearchToggler } from './advanced-search-toggler';
-export { SearchActions } from './search-actions';

package/dist/types/components/pro-search/components/search-actions.d.ts

@@ -1,10 +0,0 @@
-import { ProSearchProps } from '../props';
-import { MemoExoticComponent } from 'react';
-interface SearchActionsProps {
-    loading?: boolean;
-    searchButtonProps?: ProSearchProps<never>["searchButtonProps"];
-    resetButtonProps?: ProSearchProps<never>["resetButtonProps"];
-    onReset?: () => void;
-}
-export declare const SearchActions: MemoExoticComponent<({ loading, searchButtonProps, resetButtonProps, onReset }: SearchActionsProps) => import("@emotion/react/jsx-runtime").JSX.Element>;
-export {};

package/dist/types/components/pro-search/index.d.ts

@@ -1,5 +0,0 @@
-import { Awaitable } from '@vef-framework-react/shared';
-import { FC, ReactNode } from 'react';
-import { ProSearchProps } from './props';
-export declare const ProSearch: (<TValues = unknown>(props: ProSearchProps<TValues>) => Awaitable<ReactNode>) & Pick<FC, "displayName">;
-export type { ProSearchProps } from './props';

package/dist/types/components/pro-search/props.d.ts

@@ -1,66 +0,0 @@
-import { ResetButtonProps, SubmitButtonProps } from '@vef-framework-react/components';
-import { Except } from '@vef-framework-react/shared';
-import { ReactNode } from 'react';
-/**
- * Props for the ProSearch component
- *
- * @template TValues - The type of the search form values
- */
-export interface ProSearchProps<TValues = unknown> {
-    /**
-     * CSS class name
-     */
-    className?: string;
-    /**
-     * Default search values
-     */
-    defaultValues?: TValues;
-    /**
-     * Extra content on the left side
-     */
-    extra?: ReactNode;
-    /**
-     * Basic search content
-     */
-    basicSearch?: ReactNode;
-    /**
-     * Advanced search content
-     */
-    advancedSearch?: ReactNode;
-    /**
-     * Disabled state
-     */
-    disabled?: boolean;
-    /**
-     * Loading state
-     */
-    loading?: boolean;
-    /**
-     * Search button props
-     */
-    searchButtonProps?: Except<SubmitButtonProps, "onSubmit" | "disabled" | "loading">;
-    /**
-     * Reset button props, or false to hide the reset button
-     */
-    resetButtonProps?: Except<ResetButtonProps, "onReset" | "disabled" | "loading"> | false;
-    /**
-     * Callback when search values change
-     */
-    onSearch?: (values: NoInfer<TValues>) => void;
-    /**
-     * Callback when search is reset
-     */
-    onReset?: (defaultValues?: NoInfer<TValues>) => void;
-    /**
-     * Whether advanced search is visible by default (uncontrolled)
-     */
-    defaultAdvancedSearchVisible?: boolean;
-    /**
-     * Whether advanced search is visible (controlled)
-     */
-    advancedSearchVisible?: boolean;
-    /**
-     * Callback when advanced search visibility changes
-     */
-    onAdvancedSearchVisibleChange?: (visible: boolean) => void;
-}

package/dist/types/components/pro-search/styles.d.ts

@@ -1,6 +0,0 @@
-import { SerializedStyles } from '@emotion/serialize';
-export declare const content: SerializedStyles;
-export declare const contentLeft: SerializedStyles;
-export declare const contentRight: SerializedStyles;
-export declare const advancedSearchToggler: SerializedStyles;
-export declare const advancedSearch: SerializedStyles;