@simoncomputing/mui-bueno-v2 0.25.20 → 0.25.22

package/CHANGELOG.md

@@ -11,6 +11,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Minor increment --> singlular/minor changes. Minimal breaking changes.
 - Patch increment --> singlular/minor changes. Zero breaking changes.
 
+## [0.25.22] - 2026-02-27
+
+### Added
+
+- `SearchField`, `PageHeader`
+    - `onSearch` is now debounced at 500ms, which can be optionally overridden via the `debounceMillis` prop
+
+### Changed
+
+- `SelectableCitationManager`, `CitationManager`, `CitationField`
+    - Search is debounced by 500ms to avoid excessive calls to `getCitationsPaginated`/`getSelectedCiationsPaginated`
+
+## [0.25.21] - 2026-02-27
+
+### Added
+
+- `SelectableCitationManager`, `CitationManager`, `CitationField`
+    - Added `canSearch` prop. When true, a search bar is displayed above the citations table. The search input text can be obtained from `pageState.search` in `getCitationsPaginated(pageState: PageState)` & `getSelectedCiationsPaginated(pageState: PageState)` to allow for backend filtering.
+
+### Fixed
+
+- `SearchField`
+    - Fixed TSDoc for props
+
 ## [0.25.20] - 2026-02-26
 
 ### Fixed

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

@@ -19,6 +19,11 @@ export type PageState = {
      * Page size for paginated results (number of rows).
      */
     pageSize: number;
+
+    /**
+     * (Optional) Search criteria. For tables that support searching.
+     */
+    search?: string;
 };
 
 /**
@@ -47,7 +52,6 @@ export type Filter = {
 
 export type PaginationState = PageState & {
     totalCount: number;
-    // searchTerm?: string;
     sortField?: string;
     sortOrder?: 'asc' | 'desc';
 };

package/dist/components/Form/Inputs/CitationField/CitationField.d.ts

@@ -56,6 +56,12 @@ export type CitationFieldProps = BaseInputProps & BaseCitationManagerApiProps &
      * users will be allowed to launch URLs
      */
     canLaunchUrl?: (citation: Citation) => boolean;
+    /**
+     * When true, search bar is displayed in pop-up above table.
+     *
+     * "search" will be passed to `getCitationsPaginated` with the search input text
+     */
+    canSearch?: boolean;
 };
 /**
  * Rich Text field -- uses MUI Tip Tap

package/dist/components/Form/Inputs/CitationField/CitationManager/BaseCitationManager.d.ts

@@ -100,6 +100,13 @@ export type BaseCitationManagerProps = BaseCitationManagerApiProps & {
      * Whether users can create/edit/delete citations or not
      */
     readOnly?: boolean;
+    /**
+     * When true, search bar is displayed.
+     *
+     * { "search": <search input value> } will be passed to `getCitationsPaginated`/`getSelectedCitationsPaginated` along
+     * with the request
+     */
+    canSearch?: boolean;
 };
 export declare enum CitationManagerState {
     CITATIONS_TABLE = "Insert Citation/Attachment(s)",
@@ -117,5 +124,5 @@ export declare enum CitationManagerState {
  *
  * For in-line citations, see CitationField instead.
  */
-export declare function BaseCitationManager({ getCitationsPaginated, onCreateCitation, onUpdateCitation, onDeleteCitation, getCitationById, onDownloadAttachment, onPreviewAttachment, onSelectCitations, onCancel, initialSelectedIds, onContentChange, onError, renderAsPopup, canSelect, tableTitle, addlActions, canLaunchUrl, readOnly, }: BaseCitationManagerProps): import("react/jsx-runtime").JSX.Element;
+export declare function BaseCitationManager({ getCitationsPaginated, onCreateCitation, onUpdateCitation, onDeleteCitation, getCitationById, onDownloadAttachment, onPreviewAttachment, onSelectCitations, onCancel, initialSelectedIds, onContentChange, onError, renderAsPopup, canSelect, tableTitle, addlActions, canLaunchUrl, readOnly, canSearch, }: BaseCitationManagerProps): import("react/jsx-runtime").JSX.Element;
 export default BaseCitationManager;

package/dist/components/Form/Inputs/CitationField/CitationManager/CitationBubbleMenu.d.ts

@@ -23,4 +23,4 @@ export type CitationBubbleMenuProps = Partial<Omit<ControlledBubbleMenuProps, 'o
  * update, which will happen if it's a child of the component using
  * `useEditor`).
  */
-export default function CitationBubbleMenuTipTap({ getCitationsPaginated, getSelectedCitationsPaginated, onCreateCitation, onUpdateCitation, onDeleteCitation, getCitationById, onDownloadAttachment, onPreviewAttachment, canLaunchUrl, readOnly, ...controlledBubbleMenuProps }: CitationBubbleMenuProps): import("react/jsx-runtime").JSX.Element | null;
+export default function CitationBubbleMenuTipTap({ getCitationsPaginated, getSelectedCitationsPaginated, onCreateCitation, onUpdateCitation, onDeleteCitation, getCitationById, onDownloadAttachment, onPreviewAttachment, canLaunchUrl, readOnly, canSearch, ...controlledBubbleMenuProps }: CitationBubbleMenuProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/Form/Inputs/CitationField/CitationManager/CitationTable.d.ts

@@ -39,6 +39,12 @@ export type CitationTableProps = Omit<BaseCitationManagerApiProps, 'onCreateCita
      * Can be overridden by readOnly
      */
     canCreate?: boolean;
+    /**
+     * When true, search bar is displayed.
+     *
+     * "search" will be passed to `getCitationsPaginated` with the search input text
+     */
+    canSearch?: boolean;
     /**
      * If true, renders as readOnly table. Overrides canCreate, canEdit, canDelete.
      *

package/dist/components/Form/Inputs/SearchField/SearchField.d.ts

@@ -1,13 +1,20 @@
-/**
- * Interface for SearchField props.
- * @property {(value?: string) => void} onSearch - called each time user types a character in the input field, or when they click the search bar/'Enter' key
- * @property {string} initialValue - initial value (may be useful if using Redux)
- * @property {boolean} lazySearch - If true, onSearch will only be called when user clicks search button/'Enter' key
- */
 export type SearchFieldProps = {
-    onSearch: (value?: string) => void;
+    /**
+     * Called each time user types a character in the input field, or when they click the search bar/'Enter' key
+     */
+    onSearch: (value: string) => void;
+    /**
+     * Initial value for the input (may be useful if using Redux)
+     */
     initialValue?: string;
+    /**
+     * If true, onSearch will only be called when user clicks search button/'Enter' key
+     */
     lazySearch?: boolean;
+    /**
+     * Override the debounce search value, in milliseconds. Default: 500ms
+     */
+    debounceMillis?: number;
 };
 /**
  * Search Field component. Can be used by itself, and/or with a table to filter data (Table/PagingTable).