@simoncomputing/mui-bueno-v2 0.25.3 → 0.25.5

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.5] - 2026-02-13
+
+### Added
+
+- `DiffTable`
+    - Modified rows will now display cell-level changes
+
+### Changed
+
+- `DiffTable`
+    - Updated `column` type to `DiffTableConfig<T>` which uses `DiffTableColumn<T, K>`. This change was made to include `isEqual` & `ignoreDiff` properties.
+        - `isEqual` -- equality check for cells (optional, but highly recommended if your column returns a `ReactNode`). Used to determine if the cell should reflect a content change.
+        - `ignoreDiff` -- if true, displays the latest value in the cell instead of displaying the diff
+
+## [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

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

@@ -131,6 +131,24 @@ export type TableColumn<T, K extends keyof T> = {
     tooltip?: string;
 };
 
+/**
+ * Column Definition for DiffTable.
+ *
+ * Same properties as TableColumn but includes the following:
+ * @property {(beforeObject: T, afterObject: T) => boolean} isEqual - (Optional but recommended when `render` is implemented) if provided, used to determine whether the cell has changed
+ * @property {boolean} ignoreDiff - (Optional) if true, disables diff for the column and renders the cell normally.
+ */
+export type DiffTableColumn<T, K extends keyof T> = TableColumn<T, K> & {
+    isEqual?: (beforeObject: T, afterObject: T) => boolean;
+    ignoreDiff?: boolean;
+};
+
+export type DiffTableConfig<T> = Array<
+    {
+        [K in keyof T]: DiffTableColumnWithKey<T, K>;
+    }[keyof T]
+>;
+
 // Sort order for Tables
 export type SortOrder = 'asc' | 'desc';
 

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

@@ -12,6 +12,8 @@ export type DiffProps = {
      */
     mode?: DiffMode;
 };
+export declare const DIFF_GREEN_HIGHLIGHT = "rgba(194, 249, 112, .5)";
+export declare const DIFF_RED_HIGHLIGHT = "rgba(196, 77,86,0.3)";
 /**
  * Displays diff between two strings.
  *

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/Table/DiffTable/DiffTable.d.ts

@@ -1,4 +1,4 @@
-import { TableConfig } from '../../../@types';
+import { DiffTableConfig } from '../../../@types';
 type ChangeType = 'added' | 'deleted' | 'modified';
 export type TableDiff<T> = {
     changeType: ChangeType;
@@ -10,7 +10,7 @@ export type DiffTableProps<T> = {
     /**
      * See Table.columns
      */
-    columns: TableConfig<T>;
+    columns: DiffTableConfig<T>;
     /**
      * See Table.renderExpand
      *
@@ -25,8 +25,6 @@ export type DiffTableProps<T> = {
  * 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;

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

@@ -1,6 +1,6 @@
 import { TableProps as MuiTableProps } from '@mui/material';
 import { SystemStyleObject, Theme } from '@mui/system';
-import { SortOrder, TableConfig } from '../../@types';
+import { TableColumn, SortOrder, TableConfig } from '../../@types';
 import { default as React } from 'react';
 /**
  * Interface for table props.
@@ -146,3 +146,15 @@ export type TableProps<T> = BaseTableProps<T> & Omit<MuiTableProps, 'stickyHeade
  * {@link file://../ListPage/ListPage.tsx} which includes add & search functionality.
  */
 export declare const Table: <T extends object>(props: TableProps<T>) => import("react/jsx-runtime").JSX.Element;
+export declare const getFieldKey: <T>(col: TableColumn<T, keyof T>) => string;
+/**
+ * Renders a cell in the table.
+ * @param col The configuration for the current column
+ * @param obj The object for the current Table row
+ * @returns ReactNode of the Table cell
+ */
+export declare const renderCell: <T, K extends keyof T>(col: TableColumn<T, K>, obj: T) => React.ReactNode;
+/**
+ * Renders table cell via render method, if provided, or as-is (value).
+ */
+export declare const renderOrValue: <T, K extends keyof T>(col: TableColumn<T, K>, value: T[K], obj: T, isMobileScreen: boolean) => React.ReactNode;