@simoncomputing/mui-bueno-v2 0.25.2 → 0.25.4

package/CHANGELOG.md

@@ -11,6 +11,27 @@ 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.4] - 2026-02-09
+
+### Added
+
+- `DiffProvider`
+    - Added `getCurrentValue` to `useDiff`. Define `currentSnapshot` prop to use.
+    - Renamed `getSnapshotValue` to `getPreviousValue`
+    - If nothing is passed to `getCurrentValue`/`getPreviousValue`, the original value (`previousSnapshot`/`currentSnapshot`) will be returned
+    - Added 2nd param to `getCurrentValue`/`getPreviousValue` for the default value (recommended for arrays).
+
+## [0.25.3] - 2026-02-06
+
+### Added
+
+- `DiffTable`
+    - Added `renderExpand` prop from `Table`
+- `ReadOnly`/`Diff`
+    - Added new mode "comma". See `MultiAutocomplete` for an example.
+- `MultiAutocomplete`
+    - Added support for `DiffProvider` & `ReadOnlyProvider`
+
 ## [0.25.2] - 2026-02-05
 
 ### Changed

package/dist/components/Form/Diff/Diff.d.ts

@@ -1,4 +1,4 @@
-export type DiffMode = 'word' | 'sentence' | 'html';
+export type DiffMode = 'word' | 'sentence' | 'html' | 'comma';
 export type DiffProps = {
     beforeTxt?: string;
     afterTxt?: string;
@@ -6,6 +6,7 @@ export type DiffProps = {
      * word - use word-based diff
      * sentence - use sentence-based diff
      * html - use HTML-based diff
+     * comma - use comma-based diff
      *
      * @default sentence
      */

package/dist/components/Form/Diff/DiffContext.d.ts

@@ -4,16 +4,26 @@ type DiffContextValue = {
      */
     showDiff: boolean;
     /**
-     * Obtains the snapshot value from `previousSnapshot`.
+     * Obtains the previous value from `previousSnapshot`.
      *
-     * @param name - formik field name
+     * @param name - formik field name (leave out to get full object)
+     * @param defaultVal - default value if undefined (ex. fallback array to [])
      * @returns value in previousSnapshot (ex. name='phone' could return "999-123-1234")
      */
-    getSnapshotValue: (name: string) => any;
+    getPreviousValue: (name?: string, defaultVal?: any) => any;
+    /**
+     * Obtains the current value from `currentSnapshot` (alternative to getting the value directly form formik)
+     *
+     * @param name - formik field name (leave out to get full object)
+     * @param defaultVal - default value if undefined (ex. fallback array to [])
+     * @returns value in currentSnapshot (ex. name='phone' could return "999-123-1234")
+     */
+    getCurrentValue: (name?: string, defaultVal?: any) => any;
 };
 type DiffProviderProps = {
     showDiff?: boolean;
     previousSnapshot?: any;
+    currentSnapshot?: any;
     children: React.ReactNode;
 };
 /**
@@ -21,7 +31,8 @@ type DiffProviderProps = {
  *
  * @param showDiff - when true (default), enables text diff. Set to false to return form to normal.
  * @param previousSnapshot - previous snapshot. This should match the same stucture as your fields (i.e. formik initialValues)
+ * @param currentSnapshot - current snapshot. This should match the same structure as `previousSnapshot`
  */
-export declare const DiffProvider: ({ showDiff, previousSnapshot, children }: DiffProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DiffProvider: ({ showDiff, previousSnapshot, currentSnapshot, children, }: DiffProviderProps) => import("react/jsx-runtime").JSX.Element;
 export declare const useDiff: () => DiffContextValue;
 export {};

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

@@ -1,7 +1,7 @@
 /**
  * Base props for ALL inputs
  *
- * TODO: Add other shared props, if possible. Maybe `label`, `required`, etc.?
+ * TODO: Add other shared props, if possible. Maybe `required`, etc.?
  *
  * TODO: make sure components are correctly calling formik's handlers (onChange, onBlur, etc.) like TextField
  */

package/dist/components/Form/ReadOnly/ReadOnly.d.ts

@@ -11,5 +11,11 @@ export type ReadOnlyProps = {
     diffSnapshot?: string;
     diffMode?: DiffMode;
 } & Omit<DiffProps, 'beforeTxt' | 'afterTxt'>;
+/**
+ * To be used by form field components when a component should NOT be editable.
+ * This includes when showing the text diff of a field (showDiff from useDiff hook is true).
+ *
+ * For examples, see TextField, Select, RadioGroup, Autocomplete
+ */
 export declare const ReadOnly: (props: ReadOnlyProps) => import("react/jsx-runtime").JSX.Element;
 export default ReadOnly;

package/dist/components/Table/DiffTable/DiffTable.d.ts

@@ -7,8 +7,27 @@ export type TableDiff<T> = {
 export type DiffTableProps<T> = {
     beforeData: T[];
     afterData: T[];
+    /**
+     * See Table.columns
+     */
     columns: TableConfig<T>;
+    /**
+     * See Table.renderExpand
+     *
+     * DiffProvider will automatically be applied to content.
+     */
+    renderExpand?: (item: T) => React.ReactNode;
 };
+/**
+ * Used to display changes (additions, modifications, removals) for a set of data.
+ *
+ * Adds a new column (left) that denotes whether a row was added, changed or removed. Any unchanged
+ * rows will be counted and displayed at the bottom, under the table.
+ *
+ * Data sets MUST be objects with an id property.
+ *
+ * NOTE: Changed rows only display that the row was changed. Cell-level diff is not yet implemented.
+ */
 export declare const DiffTable: <T extends {
     id: number;
 }>(props: DiffTableProps<T>) => import("react/jsx-runtime").JSX.Element;