dinocollab-core 2.2.14 → 2.2.16

package/dist/types/filter-bar/menu/create-form-field-select-multiple.d.ts

@@ -1,13 +1,32 @@
 import type { FC } from 'react';
 import type { IFieldSelectOption } from './create-form-field-select';
 import type { IFieldMenuConfig, IFilterMenuFormProps } from './types';
+/** Props for the `FormFieldSelectMultiple` component returned by `createFormFieldSelectMultiple`. Extends the base filter-menu form props. */
 export interface IFormFieldSelectMultipleProps<T> extends IFilterMenuFormProps<T> {
 }
+/** Parameters passed to `createFormFieldSelectMultiple` to configure the generated component. */
 export interface IFormFieldSelectMultipleParam<T> {
     /** Optional configuration for the form field */
     config?: IFieldMenuConfig<T>;
     /** List of options for the select field */
     options: IFieldSelectOption[];
+    /** If true, disables the field after submission. @default false */
+    disabledAfterSubmit?: boolean;
 }
+/**
+ * Factory function that creates a `FormFieldSelectMultiple` filter-menu component.
+ *
+ * The generated component renders a checkbox list of options inside a
+ * popper/menu panel, allowing the user to select **multiple values** at once.
+ * It supports:
+ * - Controlled checkbox state to prevent uncontrolled→controlled React warnings
+ * - OR / AND logic toggle when more than one value is applied
+ * - Chip viewers showing the currently applied values
+ * - Built-in validation via an optional `validator` prop
+ * - A loading overlay that disables interaction while `isLoading` is true
+ *
+ * @param params - Static configuration (option list, optional field config override)
+ * @returns A React FC ready to be used as a multi-select filter-menu field component
+ */
 declare function createFormFieldSelectMultiple<T>(params?: IFormFieldSelectMultipleParam<T>): FC<IFormFieldSelectMultipleProps<T>>;
 export default createFormFieldSelectMultiple;

package/dist/types/filter-bar/menu/create-form-field-select.d.ts

@@ -1,17 +1,34 @@
 import { FC } from 'react';
 import type { IFieldMenuConfig, IFilterMenuFormProps } from './types';
 import type { TFieldValid } from '../types';
+/** Props for the `FormFieldSelect` component returned by `createFormFieldSelect`. Extends the base filter-menu form props. */
 export interface IFormFieldSelectProps<T> extends IFilterMenuFormProps<T> {
 }
+/** A single option item rendered as a radio button inside the select filter menu. */
 export interface IFieldSelectOption {
     value: TFieldValid;
     label?: string;
 }
+/** Parameters passed to `createFormFieldSelect` to configure the generated component. */
 export interface IFormFieldSelectParams<T> {
     /** Optional configuration for the form field */
     config?: IFieldMenuConfig<T>;
     /** List of options for the select field */
     options: IFieldSelectOption[];
 }
+/**
+ * Factory function that creates a `FormFieldSelect` filter-menu component.
+ *
+ * The generated component renders a radio-button list of options inside a
+ * popper/menu panel. It supports:
+ * - Single or multi-value selection (controlled by `config.singleValue`)
+ * - OR / AND logic toggle when more than one value is selected
+ * - Chip viewers showing the currently applied values
+ * - Built-in validation via an optional `validator` prop
+ * - A loading overlay that disables interaction while `isLoading` is true
+ *
+ * @param params - Static configuration (option list, optional field config override)
+ * @returns A React FC ready to be used as a filter-menu field component
+ */
 declare function createFormFieldSelect<T>(params: IFormFieldSelectParams<T>): FC<IFormFieldSelectProps<T>>;
 export default createFormFieldSelect;

package/dist/types/filter-bar/menu/create-form-field-string.d.ts

@@ -1,10 +1,26 @@
 import type { FC } from 'react';
 import type { IFieldMenuConfig, IFilterMenuFormProps } from './types';
+/** Props for the `FormFieldString` component returned by `createFormFieldString`. Extends the base filter-menu form props. */
 export interface IFormFieldStringProps<T> extends IFilterMenuFormProps<T> {
 }
+/** Parameters passed to `createFormFieldString` to configure the generated component. */
 export interface IFormFieldStringParam<T> {
     /** Optional configuration for the form field */
     config?: IFieldMenuConfig<T>;
 }
+/**
+ * Factory function that creates a `FormFieldString` filter-menu component.
+ *
+ * The generated component renders a free-text input inside a popper/menu panel,
+ * letting the user type arbitrary string values as filter criteria. It supports:
+ * - OR / AND logic toggle when more than one value is applied
+ * - Chip viewers showing the currently applied values
+ * - Auto-focus and input reset after each successful submission
+ * - Built-in validation via an optional `validator` prop
+ * - A loading overlay that disables interaction while `isLoading` is true
+ *
+ * @param params - Static configuration (optional field config override)
+ * @returns A React FC ready to be used as a free-text filter-menu field component
+ */
 declare function createFormFieldString<T>(params?: IFormFieldStringParam<T>): FC<IFormFieldStringProps<T>>;
 export default createFormFieldString;

package/dist/types/filter-bar/menu/create.d.ts

@@ -1,7 +1,24 @@
 import type { FC } from 'react';
 import type { IFilterMenuProps } from './types';
 import type { IFilterMenuConfig } from './types';
+/**
+ * Factory function that creates a `FilterMenu` component from a static field configuration.
+ *
+ * The generated component renders a badge icon button that opens a popper panel with:
+ * - A **field list** view — lists all configured filter fields with applied-value counts
+ * - A **field form** view — renders the appropriate input component for the selected field
+ * - A **quick-search** field (opt-out via `enableQuickSearch: false`)
+ * - OR / AND logic toggle support per field
+ * - "Clear All" action to reset all active filters at once
+ *
+ * All state (open/close, selected field) is local; filter values are read/written through
+ * `FilterBarContext` via `useFilterActions`.
+ *
+ * @param config - Static filter-menu configuration (fields, validation, slots, etc.)
+ * @returns A React FC ready to be dropped anywhere inside a `FilterBarProvider`
+ */
 export declare function createFilterMenu<T>(config: IFilterMenuConfig<T>): FC<IFilterMenuProps<T>>;
+/** CSS class names used by the `FilterMenu` component for external style overrides. */
 export declare const filterMenuClasses: {
     root: string;
     input: string;

package/dist/types/filter-bar/menu/types.d.ts

@@ -1,11 +1,20 @@
 import type { ComponentType } from 'react';
 import type { BoxProps, PopperProps } from '@mui/material';
 import type { FormValidator, IFormValidatorConfig } from '../../form/validator';
-import type { TFieldModelValid, TFieldType, TFieldValid, TFieldValue } from '../types';
+import type { TFieldModelValid, TFieldType, TFieldValid, TFieldValue, TLogic } from '../types';
 export interface IFieldMenuConfig<T> {
     field: TFieldType<T>;
     label?: string;
+    /** If true, the form will only allow a single value to be added for the field */
     singleValue?: boolean;
+    /** If true, the form will replace the existing value with the new value */
+    replaceValue?: boolean;
+    /** If true, the menu will close after submitting a value @default true */
+    closeAfterSubmit?: boolean;
+    /** Default logic for combining multiple values for the field */
+    defaultLogic?: TLogic;
+    /** Tooltip for the field */
+    tooltip?: string | ((values?: TFieldValid[]) => string);
     /** Default form component for the field is `String` */
     FormComponent?: ComponentType<IFilterMenuFormProps<T>>;
 }
@@ -33,6 +42,8 @@ export interface IFilterMenuConfig<T> extends IFilterMenuSlots {
     quickSearchHint?: string | ((currentHint: string) => string);
     /** Option to enable or disable quick search @default true */
     enableQuickSearch?: boolean;
+    /** Option to close the menu after submitting a value @default true */
+    closeAfterSubmit?: boolean;
 }
 export interface IFilterMenuConfigInternal<T> extends Omit<IFilterMenuConfig<T>, 'fields'> {
     fields: TFieldMenuConfigsInternal<T>;

package/dist/types/filter-bar/types.d.ts

@@ -59,6 +59,7 @@ export type TFieldSort<T> = {
  * @vi Dinh nghia cac kieu co ban cho he thong filter bar, bao gom gia tri filter, kieu field va cau truc tong the cua filter state.
  */
 export type TLogic = 'and' | 'or';
+export type TDateLogic = 'before' | 'after' | 'on' | 'range';
 /**
  * @en
  * - Structure for storing filter values and their logical relationship (AND/OR) for each field.
@@ -68,6 +69,8 @@ export type TLogic = 'and' | 'or';
 export type TFieldValue = {
     /** Logical operator for combining values within this field. Default is 'and'. */
     logic?: TLogic;
+    /** Logical operator for date-specific filtering. Optional. */
+    dateLogic?: TDateLogic;
     values: TFieldValid[];
 };
 /**

package/dist/types/table/helpers.d.ts

@@ -1,9 +1,6 @@
 import { GridFilterModel, GridSortModel } from '@mui/x-data-grid';
 import { GridInitialStateCommunity } from '@mui/x-data-grid/models/gridStateCommunity';
 import { ICustomGridSortModel, ITableQueryParams, ITableQueryDetail } from './types';
-export declare const dinoTableClasses: {
-    whiteSpacePre: string;
-};
 export interface ITableQueryParamModel {
     table?: string;
 }

package/dist/types/table/index.d.ts

@@ -3,6 +3,6 @@ export * from './model-filter';
 export * from './create.action-row';
 export * from './create.table';
 export { default as DinoTable } from './dino';
-export { dinoTableClasses } from './helpers';
+export { dinoTableClasses } from './styled';
 export type { IStatusCellConfig } from './ui.units';
 export type { IExportCsvOptionsModel } from './csv-export-helper';

package/dist/types/table/styled.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+export declare const dinoTableClasses: {
+    root: string;
+    whiteSpacePre: string;
+};
+export declare const TableStyled: import("@emotion/styled").StyledComponent<import("@mui/system").BoxOwnProps<import("@mui/material").Theme> & import("@mui/material/OverridableComponent").CommonProps & Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    ref?: ((instance: HTMLDivElement | null) => void) | import("react").RefObject<HTMLDivElement> | null | undefined;
+}, keyof import("@mui/material/OverridableComponent").CommonProps | keyof import("@mui/system").BoxOwnProps<import("@mui/material").Theme>> & import("@mui/system").MUIStyledCommonProps<import("@mui/material").Theme>, {}, {}>;

package/dist/types/table/toolbar-pannel.d.ts

@@ -25,6 +25,11 @@ export interface IToolbarPannelProps {
     exportCsvOptions?: IExportCsvOptionsModel;
 }
 declare class ToolbarPannel extends Component<React.PropsWithChildren<IToolbarPannelProps>> {
+    private _popperObserver;
+    private _elementObserver;
+    private _observedPopper;
+    componentDidMount(): void;
+    componentWillUnmount(): void;
     render(): import("react/jsx-runtime").JSX.Element;
     renderTitle: () => import("react/jsx-runtime").JSX.Element;
     renderEndAdornment: () => import("react/jsx-runtime").JSX.Element;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dinocollab-core",
-  "version": "2.2.14",
+  "version": "2.2.16",
   "description": "Dinocollab core - libraries for building collaborative applications with React 18",
   "main": "dist/index.js",
   "module": "dist/index.js",