@simoncomputing/mui-bueno-v2 0.29.4 → 0.31.0

package/CHANGELOG.md

@@ -11,6 +11,44 @@ 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.31.0] - 2026-06-19
+
+### Changed
+
+- `CitationManager`/`SelectableCitationManager`
+    - Added close buttons to the top-right of the edit/view pop-up
+
+- `CitationField`/`CitationManager`/`SelectableCitationManager`
+    - Added extra param `selectedIds` to `getCitationsPaginated: (req: PageState, selectedIds: number[])` which will provide the selected ids of the citations, if any, of the current target. If none, the array will be empty. This is recommended to be used to assist with server-side sorting so that the paginated citations will return with the selected citations listed first.
+
+### Fixed
+
+- `CitationField`/`CitationManager`/`SelectableCitationManager`
+    - Fixed title of edit/view popup, which was showing "Edit Citation"/"Edit Attachment" when the form was read-only
+
+## [0.30.0] - 2026-06-19
+
+### Changed
+
+- `CitationField`
+    - When user clicks on a **_single_** inline citation, the popup will open directly to the detail page
+        - A "View All Citations" button is available to allow the user to append other citations and/or make other changes
+        - "Save"/"Cancel" buttons will close the popup, unless the user clicks "View All Citaitons", then normal routing will resume (i.e., the user will be taken to the citation table when clicking "Save"/"Cancel" and the "View All Citations" button will not display)
+- `CitationManager`, `SelectableCitationManager`
+    - Renamed `onCancel` to `onClose` to clarify that the popup should close by the caller when this is called
+- `CitationField`, `CitationManager`, `SelectableCitationManager`
+    - `getCitationById` parameter type changed from `citation: Citation` to `citationId: number`
+    - Users on a the detailed citation view can now launch URLs and preview/download attachments
+        - `canLaunchUrl` must return true for URLs to launchable
+        - URL will display as a hyperlink when the form is read-only
+        - Replaced "Save" button labels ("Create New Citation"/"Upload Attachment"/"Update Citation"/"Update Attachment") with generic "Save" label for consistency
+        - Tweaked minimum width to be `400px` instead of `300px`
+
+### Fixed
+
+- `DateField`/`DateRangeField`
+    - Fixed size of label not consistent with other fields when `readOnly` prop is true
+
 ## [0.29.4] - 2026-06-04
 
 ### Fixed

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

@@ -6,7 +6,7 @@ export type BaseCitationManagerApiProps = {
      *
      * Error handling is supported internally.
      */
-    getCitationsPaginated: (req: PageState) => Promise<PageResponse<Citation>>;
+    getCitationsPaginated: (req: PageState, selectedIds: number[]) => Promise<PageResponse<Citation>>;
     /**
      * API call for creating a new citation/attachment.
      *
@@ -57,8 +57,10 @@ export type BaseCitationManagerProps = BaseCitationManagerApiProps & {
     onSelectCitations: (citationIds: number[]) => void;
     /**
      * Callback for when the user clicks the "Cancel" button. If you're using a modal, close your modal here.
+     *
+     * Button is named "Cancel" instead of "Close" because if the user has changed their selection, it will not be saved.
      */
-    onCancel: () => void;
+    onClose: () => void;
     /**
      * Callback whenever the size of the content potentially changes. Use this if you're using something like
      * a Popper, so that it can reposition itself when the dimensions of its content changes.
@@ -113,9 +115,7 @@ export declare enum CitationManagerState {
     ADD_CITATION = "Add Citation",
     EDIT_CITATION = "Edit Citation",
     ADD_ATTACHMENT = "Add Attachment",
-    EDIT_ATTACHMENT = "Edit Attachment",
-    VIEW_CITATION = "View Citation",
-    VIEW_ATTACHMENT = "View Attachment"
+    EDIT_ATTACHMENT = "Edit Attachment"
 }
 /**
  * BaseCitationManager handles creating, updating, deleting, downloading and selecting citations.
@@ -124,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, canSearch, }: BaseCitationManagerProps): import("react/jsx-runtime").JSX.Element;
+export declare function BaseCitationManager({ getCitationsPaginated, onCreateCitation, onUpdateCitation, onDeleteCitation, getCitationById, onDownloadAttachment, onPreviewAttachment, onSelectCitations, onClose, 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/Buttons/DownloadFileBtn.d.ts

@@ -0,0 +1,7 @@
+import { Citation } from '../../../../../../@types';
+export type DownloadFileBtnProps = {
+    citation: Citation;
+    onDownloadAttachment?: (citation: Citation) => Promise<void>;
+};
+export declare function DownloadFileBtn({ onDownloadAttachment, citation }: DownloadFileBtnProps): import("react/jsx-runtime").JSX.Element | undefined;
+export default DownloadFileBtn;

package/dist/components/Form/Inputs/CitationField/CitationManager/Buttons/LaunchUrlBtn.d.ts

@@ -0,0 +1,8 @@
+import { Citation } from '../../../../../../@types';
+export type LaunchUrlBtnProps = {
+    canLaunchUrl?: (citation: Citation) => boolean;
+    citation: Citation;
+    asLink?: boolean;
+};
+export declare function LaunchUrlBtn({ canLaunchUrl, citation, asLink }: LaunchUrlBtnProps): import("react/jsx-runtime").JSX.Element | null;
+export default LaunchUrlBtn;

package/dist/components/Form/Inputs/CitationField/CitationManager/Buttons/PreviewFileBtn.d.ts

@@ -0,0 +1,7 @@
+import { Citation } from '../../../../../../@types';
+export type PreviewFileBtnProps = {
+    citation: Citation;
+    onPreviewAttachment?: (citation: Citation) => Promise<void>;
+};
+export declare function DownloadFileBtn({ onPreviewAttachment, citation }: PreviewFileBtnProps): import("react/jsx-runtime").JSX.Element | undefined;
+export default DownloadFileBtn;

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

@@ -1,6 +1,6 @@
 import { ControlledBubbleMenuProps } from 'mui-tiptap';
 import { SelectableCitationManagerProps } from './SelectableCitationManager';
-export type CitationBubbleMenuProps = Partial<Omit<ControlledBubbleMenuProps, 'open' | 'editor' | 'children' | 'classes'>> & Omit<SelectableCitationManagerProps, 'onCancel' | 'onSelectCitations'> & {
+export type CitationBubbleMenuProps = Partial<Omit<ControlledBubbleMenuProps, 'open' | 'editor' | 'children' | 'classes'>> & Omit<SelectableCitationManagerProps, 'onClose' | 'onSelectCitations'> & {
     onChanged?: (ids: number[]) => void;
 };
 /**

package/dist/components/Form/Inputs/CitationField/CitationManager/{AttachmentForm.d.ts → CitationForms/AttachmentForm.d.ts}

@@ -1,8 +1,8 @@
-import { Citation, UnsavedAttachmentCitation } from '../../../../../@types';
+import { Citation, UnsavedAttachmentCitation } from '../../../../../../@types';
 export type AttachmentFormProps = {
-    title: string;
     onSave: (unsavedAttachment: UnsavedAttachmentCitation) => Promise<void>;
     onCancel: () => void;
+    onViewCitationTable: () => void;
     onClose: () => void;
     modifyCitation: Citation | undefined;
     /**
@@ -10,10 +10,9 @@ export type AttachmentFormProps = {
      */
     disableFileUpload?: boolean;
     readOnly?: boolean;
-    /**
-     * If true, shows a close button inline with title. Intended to be used within modals.
-     */
-    showCloseBtn?: boolean;
+    showViewAllCitationsBtn?: boolean;
+    onDownloadAttachment: ((citation: Citation) => Promise<void>) | undefined;
+    onPreviewAttachment: ((citation: Citation) => Promise<void>) | undefined;
 };
 declare const AttachmentForm: (props: AttachmentFormProps) => import("react/jsx-runtime").JSX.Element;
 export default AttachmentForm;

package/dist/components/Form/Inputs/CitationField/CitationManager/CitationForms/CitationFormActions/CitationFormActions.d.ts

@@ -0,0 +1,13 @@
+export type CitationFormActionsProps = {
+    onCancel: () => void;
+    onViewCitationTable: () => void;
+    readOnly?: boolean;
+    showViewAllCitationsBtn?: boolean;
+    isLoading: boolean;
+    onSaveClicked: () => void;
+};
+/**
+ * Action buttons (Save, Cancel, View All Citations) for the Citation/URL and Attachment forms
+ */
+declare const CitationFormActions: (props: CitationFormActionsProps) => import("react/jsx-runtime").JSX.Element | null;
+export default CitationFormActions;

package/dist/components/Form/Inputs/CitationField/CitationManager/{UrlForm.d.ts → CitationForms/UrlForm.d.ts}

@@ -1,13 +1,13 @@
-import { Citation, UnsavedUrlCitation } from '../../../../../@types';
+import { Citation, UnsavedUrlCitation } from '../../../../../../@types';
 export type UrlFormProps = {
-    title: string;
     onSave: (unsavedUrl: UnsavedUrlCitation) => Promise<void>;
     onCancel: () => void;
+    onViewCitationTable: () => void;
     onClose: () => void;
     modifyCitation: Citation | undefined;
     readOnly?: boolean;
-    /** If true, shows a close button inline with title. Intended to be used within modals. */
-    showCloseBtn?: boolean;
+    showViewAllCitationsBtn?: boolean;
+    canLaunchUrl?: (citation: Citation) => boolean;
 };
 declare const UrlForm: (props: UrlFormProps) => import("react/jsx-runtime").JSX.Element;
 export default UrlForm;

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

@@ -1,5 +1,5 @@
 import { BaseCitationManagerProps } from './BaseCitationManager';
-export type CitationManagerProps = Omit<BaseCitationManagerProps, 'initialSelectedIds' | 'onSelectCitations' | 'onCancel' | 'onContentChange' | 'renderAsPopup' | 'canSelect'>;
+export type CitationManagerProps = Omit<BaseCitationManagerProps, 'initialSelectedIds' | 'onSelectCitations' | 'onClose' | 'onContentChange' | 'renderAsPopup' | 'canSelect'>;
 /**
  * CitationManager is a basic table that handles creating, updating, and deleting citations.
  */

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

@@ -7,10 +7,10 @@ export type CitationTableProps = Omit<BaseCitationManagerApiProps, 'onCreateCita
     onCancel: () => void;
     onNewCitation: () => void;
     onNewAttachment: () => void;
-    onEditCitation?: (citation: Citation) => void;
-    onEditAttachment?: (citation: Citation) => void;
-    onViewCitation?: (citation: Citation) => void;
-    onViewAttachment?: (citation: Citation) => void;
+    onEditCitation?: (citationId: number) => void;
+    onEditAttachment?: (citationId: number) => void;
+    onViewCitation?: (citationId: number) => void;
+    onViewAttachment?: (citationId: number) => void;
     onSelect: (selectedIds: number[]) => void;
     selectedIds: number[];
     setSelectedIds: React.Dispatch<React.SetStateAction<number[]>>;

package/dist/components/Form/Inputs/CitationField/CitationManager/Poppers/LaunchUrlPopper/LaunchUrlPopper.d.ts

@@ -3,6 +3,7 @@ type Props = {
     citation: Citation | null;
     anchorEl: HTMLElement | null;
     onClose: () => void;
+    open: boolean;
 };
 /**
  * Popper to ask the user to confirm if they want to navigate to the citation's URL.