@simoncomputing/mui-bueno-v2 0.18.18 → 0.19.0

package/CHANGELOG.md

@@ -11,6 +11,25 @@ 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.19.0] - 2025-10-16
+
+### Changed
+
+- `Error`
+
+    - Renamed component to `ValidationError` to avoid confusion with JS's built-in Error class. **Migration:** Rename references to `Error` component to `ValidationError`.
+    - Replaced `collapseWhenEmpty` with `errorMode`, which supports an additional mode `none` to always hide errors. **Migration:** When `collapseWithEmpty` is true, use `errorMode="hidden"` or `errorMode="collapse"`.
+
+- All Form Input components (`Autocomplete`, `MultiAutocomplete`, `Checkbox`, `CheckboxGroup`, `CitationField`, `DateField`, `DateRangeField`, `FileUpload`, `Location`, `RadioGroup`, `Select`, `Switch`, `TextField`)
+    - Replaced `collapseErrorWhenEmpty` with `errorMode`, which supports an additional mode `none` to always hide errors
+
+## [0.18.19] - 2025-10-09
+
+### Fixed
+
+- `CitationField`
+    - Field not clearing when formik clears its value
+
 ## [0.18.18] - 2025-10-08
 
 ### Added

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

@@ -10,13 +10,19 @@ export type BaseInputProps = {
      */
     name: string;
     /**
-     * When true, compoent will not take up space when no error(s) exist. This is recommended when
-     * validation is not needed.
+     * Error mode for showing validation error messages.
      *
-     * When false or undefined, component will take up space when no error(s) exist. This is recommended when
-     * the field and/or form requires validation, to prevent form jittering as errors show/hide.
+     * 'normal' -- displays an error message under the field, when FormikErrors has an error that matches the field's `name`.
+     *             Space is preserved for the error, even when not visible, to prevent the form from jittering up/down as errors show/hide.
      *
-     * @default undefined
+     * 'collapse' -- displays an error message under the field, when FormikErrors has an error that matches the field's `name`.
+     *               Space is NOT preserved for the error. Use sparringly. If validation is not needed, consider using 'hidden' instead.
+     *
+     * 'hidden' -- does not display an error message, even when present. FormikErrors that match the field's `name` are ignored.
+     *           Recommended when the field does not need validation, or you plan to handle errors manually for the field.
+     *
+     * @default 'normal'
      */
-    collapseErrorWhenEmpty?: boolean;
+    errorMode?: ErrorMode;
 };
+export type ErrorMode = 'normal' | 'collapse' | 'hidden';

package/dist/components/Form/{Error/Error.d.ts → ValidationError/ValidationError.d.ts}

@@ -1,5 +1,6 @@
+import { ErrorMode } from '../Inputs/BaseInputProps';
 import * as React from 'react';
-export type ErrorProps = {
+export type ValidationErrorProps = {
     /**
      * Name of the component.
      * @required
@@ -15,17 +16,11 @@ export type ErrorProps = {
      * Specifies the styling on the typography.
      */
     className?: string;
-    /**
-     * When true, compoent will not take up space when no error(s) exist.
-     * When false, component will take up space when no error(s) exist.
-     *
-     * @default false
-     */
-    collapseWhenEmpty?: boolean;
+    errorMode?: ErrorMode;
 };
 /**
  * This component provides a simple error block containing
  * an error and status
  */
-export declare const Error: React.FC<ErrorProps>;
-export default Error;
+export declare const ValidationError: React.FC<ValidationErrorProps>;
+export default ValidationError;