@simoncomputing/mui-bueno-v2 0.15.1 → 0.15.2

package/CHANGELOG.md

@@ -11,6 +11,21 @@ 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.15.2] - 2025-07-16
+
+### Added
+
+- `CitationField`/`CitationMenu`:
+    - Users can delete citation/attachment(s)
+    - Submit buttons when creating or updating citations & attachments will show loading indication while saving
+- `LoadingButton`: Shows a loading spinner and disables itself when `loading` is true. Intended to be used with forms.
+
+### Fixed
+
+- `CitationField`
+    - reposition citation bubble menu when an error appears/disappears to avoid the content from getting cut off
+    - ignore citation(s) that cannot be resolved (ids to citations that no longer exist). This will visually hide the citation links but the underlying HTML will still contain them, so the service should handle any manual cleanup if a citation is deleted but it is still being referenced in the `CitationField`.
+
 ## [0.15.1] - 2025-07-14
 
 ### Added

package/dist/components/Buttons/LoadingButton/LoadingButton.d.ts

@@ -0,0 +1,11 @@
+import { ButtonProps } from '../Button/Button';
+import * as React from 'react';
+export type LoadingButtonProps = Omit<ButtonProps, 'startIcon' | 'loading'> & {
+    loading?: boolean;
+};
+/**
+ * Button with a loading spinner. Automatically disables itself when loading.
+ *
+ * Intended to be used with forms, so the default type is `submit`.
+ */
+export declare const LoadingButton: React.FC<LoadingButtonProps>;

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

@@ -2,7 +2,7 @@ import { Extension } from '@tiptap/core';
 import { CitationBubbleMenuProps } from './CitationMenu/CitationBubbleMenu';
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
-        citation: {
+        citationBubbleMenu: {
             /**
              * Open/show the link bubble menu. Create a link if one doesn't exist at
              * the current cursor selection, or edit the existing link if there is
@@ -28,7 +28,7 @@ export type CitationBubbleMenuHandlerStorage = {
     isOpen: boolean;
     selectedIds: number[];
     bubbleMenuOptions: Partial<CitationBubbleMenuProps> | undefined;
-    selectedNodePos: number | undefined;
+    selectedNodePos: number;
 };
 /**
  * To be used in conjunction with the `CitationBubbleMenuTipTap` component, as this

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

@@ -40,36 +40,37 @@ export type CitationFieldProps = {
     /**
      * API call for fetching paginated citations. These will populate the "Insert Citation/Attachment(s)" table.
      *
-     * If an error occurs during the API call, notify the user then throw the error so that
-     * Mui Bueno can handle updating state.
+     * Error handling is supported internally.
      */
     fetchExistingCitations: (req: PageState) => Promise<PageResponse<Citation>>;
     /**
      * API call for creating a new citation/attachment.
      *
-     * If an error occurs during the API call, notify the user then throw the error so that
-     * Mui Bueno can handle updating state.
+     * Error handling is supported internally.
      */
     onCreateCitation: (citation: UnsavedCitation) => Promise<Citation>;
     /**
      * API call for updating a citation/attachment.
      *
-     * If an error occurs during the API call, notify the user then throw the error so that
-     * Mui Bueno can handle updating state.
+     * Error handling is supported internally.
      */
     onUpdateCitation: (citation: Citation) => Promise<Citation>;
+    /**
+     * API call for updating a citation/attachment.
+     *
+     * Error handling is supported internally.
+     */
+    onDeleteCitation: (id: number) => Promise<void>;
     /**
      * API call for retrieving a citation by id
      *
-     * If an error occurs during the API call, notify the user then throw the error so that
-     * Mui Bueno can handle updating state.
+     * Error handling is supported internally.
      */
     getCitationById: (id: number) => Promise<Citation>;
     /**
      * API call for storing an attachment (ex. in an s3 bucket)
      *
-     * If an error occurs during the API call, notify the user then throw the error so that
-     * Mui Bueno can handle updating state.
+     * Error handling is supported internally.
      */
     onStoreAttachment: (citation: UnsavedAttachment) => Promise<Citation>;
     /**

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

@@ -3,6 +3,7 @@ interface SyncContextType {
     citations: Citation[];
     resync: () => void;
     addUpdateCitation: (citation: Citation) => void;
+    deleteCitation: (id: number) => void;
 }
 export declare const SyncContext: import('react').Context<SyncContextType | undefined>;
 export declare const useCitationSync: () => SyncContextType;

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

@@ -24,4 +24,4 @@ export type CitationBubbleMenuProps = Partial<Except<ControlledBubbleMenuProps,
  * update, which will happen if it's a child of the component using
  * `useEditor`).
  */
-export default function CitationBubbleMenuTipTap({ fetchExistingCitations, onCreateCitation, onUpdateCitation, getCitationById, onStoreAttachment, ...controlledBubbleMenuProps }: CitationBubbleMenuProps): import("react/jsx-runtime").JSX.Element | null;
+export default function CitationBubbleMenuTipTap({ fetchExistingCitations, onCreateCitation, onUpdateCitation, onDeleteCitation, getCitationById, onStoreAttachment, ...controlledBubbleMenuProps }: CitationBubbleMenuProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -12,6 +12,10 @@ export interface CitationMenuProps {
      * API call for updating a citation/attachment.
      */
     onUpdateCitation: (citation: Citation) => Promise<Citation>;
+    /**
+     * API call for deleting a citation/attachment.
+     */
+    onDeleteCitation: (id: number) => Promise<void>;
     /**
      * API call for retrieving a citation by id
      */
@@ -70,5 +74,5 @@ export declare enum CitationMenuState {
  *
  * Intended to be used within a bubble/pop-up/modal/dialog. For in-line citations, see CitationField instead.
  */
-export declare function CitationMenu({ fetchExistingCitations, onCreateCitation, onUpdateCitation, getCitationById, onStoreAttachment, onSelectCitations, onCancel, initialSelectedIds, onContentUpdate, onError, }: CitationMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function CitationMenu({ fetchExistingCitations, onCreateCitation, onUpdateCitation, onDeleteCitation, getCitationById, onStoreAttachment, onSelectCitations, onCancel, initialSelectedIds, onContentUpdate, onError, }: CitationMenuProps): import("react/jsx-runtime").JSX.Element;
 export default CitationMenu;

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

@@ -1,10 +1,12 @@
 import { PageState, PageResponse, Citation } from '../../../../../@types';
+import { CitationMenuError } from './CitationMenu';
 export type CitationTableProps = {
     onCancel: () => void;
     onNewCitation: () => void;
     onNewAttachment: () => void;
     onEditCitation: (citation: Citation) => void;
     onEditAttachment: (citation: Citation) => void;
+    onDeleteCitation: (id: number) => Promise<void>;
     onSelect: (selectedIds: number[]) => void;
     fetchExistingCitations: (req: PageState) => Promise<PageResponse<Citation>>;
     selectedIds: number[];
@@ -16,6 +18,7 @@ export type CitationTableProps = {
      * help debug issues so developers can see specific details about an error.
      */
     onError?: (err: string) => void;
+    setError: React.Dispatch<React.SetStateAction<CitationMenuError | undefined>>;
 };
 declare const CitationTable: (props: CitationTableProps) => import("react/jsx-runtime").JSX.Element;
 export default CitationTable;

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

@@ -1,2 +1,15 @@
 import { Node } from '@tiptap/core';
+declare module '@tiptap/core' {
+    interface Commands<ReturnType = any> {
+        citation: {
+            insertCitation: (attrs: {
+                ids: number[];
+            }) => ReturnType;
+            updateCitation: (attrs: {
+                ids: number[];
+            }, pos: number) => ReturnType;
+            deleteCitation: (pos: number) => ReturnType;
+        };
+    }
+}
 export declare const CitationNode: Node<any, any>;