@xh/hoist 76.0.0-SNAPSHOT.1757274887417 → 76.0.0-SNAPSHOT.1757949377824

package/CHANGELOG.md

@@ -22,6 +22,7 @@
   views will be pinned by default.  This feature was deemed too confusing, and not useful in
   practice.  App maintainers should ensure that all global views are appropriate and well
   organized enough to be shown immediately to new users in the view menu.
+* New constraint rule: `validEmails` - to validate one or more email addresses in an input field.
 
 ### 🐞 Bug Fixes
 
@@ -40,6 +41,10 @@
 * Added control to trigger browser GC from app footer. Useful for troubleshooting memory issues.
   Requires running chromium-based browser via e.g. `start chrome --js-flags="--expose-gc`.
 
+### ⚙️ Typescript API Adjustments
+
+* Corrected `ColChooserConfig` `width` and `height` types.
+
 ## 75.0.1 - 2025-08-11
 
 ### 🎁 New Features

package/build/types/cmp/grid/Types.d.ts

@@ -99,9 +99,9 @@ export interface ColChooserConfig {
      */
     autosizeOnCommit?: boolean;
     /** Chooser width for popover and dialog. Desktop only. */
-    width?: number;
+    width?: string | number;
     /** Chooser height for popover and dialog. Desktop only. */
-    height?: number;
+    height?: string | number;
 }
 /**
  * Sort comparator function for a grid column. Note that this comparator will also be called if

package/build/types/data/validation/constraints.d.ts

@@ -10,10 +10,21 @@ import { Constraint } from './Rule';
  */
 export declare const required: Constraint;
 /**
- * Validate an email address.
- * https://stackoverflow.com/questions/46155/how-to-validate-an-email-address-in-javascript/46181#46181.
+ * Validate a single email address in a field that expects only one email address.
  */
 export declare const validEmail: Constraint<string>;
+/**
+ * Validate all email addresses in a field that allows multiple email addresses
+ * separated by a semicolon - the separator used by Outlook for multiple email addresses.
+ * All email addresses must be unique.
+ */
+export declare function validEmails(c?: ValidEmailsOptions): Constraint<string>;
+export interface ValidEmailsOptions {
+    /** Require at least N email addresses. */
+    minCount?: number;
+    /** Require no more than N email addresses. */
+    maxCount?: number;
+}
 /** Validate length of a string.*/
 export declare function lengthIs(c: LengthIsOptions): Constraint<string>;
 export interface LengthIsOptions {

package/cmp/grid/Types.ts

@@ -136,10 +136,10 @@ export interface ColChooserConfig {
     autosizeOnCommit?: boolean;
 
     /** Chooser width for popover and dialog. Desktop only. */
-    width?: number;
+    width?: string | number;
 
     /** Chooser height for popover and dialog. Desktop only. */
-    height?: number;
+    height?: string | number;
 }
 
 /**

package/data/validation/constraints.ts

@@ -5,7 +5,7 @@
  * Copyright © 2025 Extremely Heavy Industries Inc.
  */
 import {LocalDate} from '@xh/hoist/utils/datetime';
-import {isArray, isEmpty, isFinite, isNil, isString} from 'lodash';
+import {isArray, isEmpty, isFinite, isNil, isString, uniq} from 'lodash';
 import moment from 'moment';
 import {Constraint} from './Rule';
 /**
@@ -27,19 +27,52 @@ export const required: Constraint = ({value, displayName}) => {
 };
 
 /**
- * Validate an email address.
- * https://stackoverflow.com/questions/46155/how-to-validate-an-email-address-in-javascript/46181#46181.
+ * Validate a single email address in a field that expects only one email address.
  */
 export const validEmail: Constraint<string> = ({value, displayName}) => {
     if (isNil(value)) return null;
 
-    // prettier-ignore
-    // eslint-disable-next-line no-useless-escape
-    const re = /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/,
-        isValid = re.test(value);
-    if (!isValid) return `${displayName} is not a properly formatted address.`;
+    const isValid = emailRegEx.test(value);
+    if (!isValid) return `${displayName} is not a properly formatted email address.`;
 };
 
+/**
+ * Validate all email addresses in a field that allows multiple email addresses
+ * separated by a semicolon - the separator used by Outlook for multiple email addresses.
+ * All email addresses must be unique.
+ */
+export function validEmails(c?: ValidEmailsOptions): Constraint<string> {
+    return ({value, displayName}) => {
+        if (isNil(value)) return null;
+
+        const emails = value
+            .split(';')
+            .map(it => it.trim())
+            .filter(Boolean);
+
+        if (uniq(emails).length !== emails.length) {
+            return `${displayName} must not contain duplicate email addresses.`;
+        }
+        if (emails.length < c?.minCount) {
+            return `${displayName} must contain at least ${c.minCount} email addresses.`;
+        }
+        if (!isNil(c?.maxCount) && emails.length > c.maxCount) {
+            return `${displayName} must contain no more than ${c.maxCount} email addresses.`;
+        }
+
+        const isValid = emails.every(it => emailRegEx.test(it));
+
+        if (!isValid) return `${displayName} has an improperly formatted email address.`;
+    };
+}
+export interface ValidEmailsOptions {
+    /** Require at least N email addresses. */
+    minCount?: number;
+
+    /** Require no more than N email addresses. */
+    maxCount?: number;
+}
+
 /** Validate length of a string.*/
 export function lengthIs(c: LengthIsOptions): Constraint<string> {
     return ({value, displayName}) => {
@@ -197,3 +230,8 @@ export const isValidJson: Constraint = ({value, displayName}) => {
         return `${displayName} is not valid JSON`;
     }
 };
+
+// https://stackoverflow.com/questions/46155/how-to-validate-an-email-address-in-javascript/46181#46181
+// prettier-ignore
+// eslint-disable-next-line no-useless-escape
+const emailRegEx = /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xh/hoist",
-  "version": "76.0.0-SNAPSHOT.1757274887417",
+  "version": "76.0.0-SNAPSHOT.1757949377824",
   "description": "Hoist add-on for building and deploying React Applications.",
   "repository": "github:xh/hoist-react",
   "homepage": "https://xh.io",