@wix/patterns-fields 1.95.0 → 1.96.0

package/dist/types/services/atlas/types.d.ts

@@ -1,4 +1,4 @@
-import { location } from '@wix/atlas';
+import type { autocomplete, location } from '@wix/atlas';
 /**
  * The @wix/atlas SDK types are auto-generated from public API schemas and are incomplete.
  */
@@ -6,8 +6,12 @@ type SdkAddress = NonNullable<location.SearchResult['address']>;
 export interface AtlasAddress extends SdkAddress {
     formatted?: string;
 }
+export type AtlasPrediction = autocomplete.Prediction;
 export interface AtlasService {
     searchAddress: (query: string) => Promise<AtlasAddress[]>;
+    /** Supply both methods to show predictions and resolve the selected place. */
+    predictAddress?: (query: string) => Promise<AtlasPrediction[]>;
+    getAddress?: (searchId: string) => Promise<AtlasAddress | undefined>;
 }
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types/services/atlas/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/atlas/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,KAAK,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;AAEhE,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC3D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/atlas/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,KAAK,UAAU,GAAG,WAAW,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;AAEhE,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,eAAe,GAAG,YAAY,CAAC,UAAU,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAC1D,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;CACtE"}

package/dist/types/services/atlas/wix-atlas-service.d.ts

@@ -1,9 +1,14 @@
-import type { AtlasService, AtlasAddress } from './types';
+import type { WixPatternsContainer } from '@wix/bex-core';
+import type { AtlasService, AtlasAddress, AtlasPrediction } from './types';
 /**
  * Wix Atlas service implementation for address search/autocomplete
  * Uses the public @wix/atlas SDK which handles authentication automatically
  */
 export declare class WixAtlasService implements AtlasService {
+    private readonly errorHandler?;
+    constructor(errorHandler?: WixPatternsContainer["errorHandler"] | undefined);
+    predictAddress(query: string): Promise<AtlasPrediction[]>;
+    getAddress(searchId: string): Promise<AtlasAddress | undefined>;
     searchAddress(query: string): Promise<AtlasAddress[]>;
 }
 //# sourceMappingURL=wix-atlas-service.d.ts.map

package/dist/types/services/atlas/wix-atlas-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wix-atlas-service.d.ts","sourceRoot":"","sources":["../../../../src/services/atlas/wix-atlas-service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG1D;;;GAGG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAC5C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAc5D"}
+{"version":3,"file":"wix-atlas-service.d.ts","sourceRoot":"","sources":["../../../../src/services/atlas/wix-atlas-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG3E;;;GAGG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAEhD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;gBAAb,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,YAAA;IAGhE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAQzD,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAQ/D,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAiB5D"}

package/dist/types/types/validation.d.ts

@@ -28,6 +28,8 @@ export interface CharactersLimitFieldValidationRuleConfig {
     separator: string;
     outOfBoundsError(min: number, max: number): string;
     maxBelowMinError: string;
+    /** Shown under this rule while another rule blocks it. */
+    exclusiveRulesExplanation?: string;
 }
 export interface SpecificValuesFieldValidationRuleConfig {
     type: 'specificValues';
@@ -37,7 +39,8 @@ export interface SpecificValuesFieldValidationRuleConfig {
     duplicateError: string;
     addButton: string;
     removeButton: string;
-    exclusiveRulesExplanation: string;
+    /** Shown under this rule while another rule blocks it. */
+    exclusiveRulesExplanation?: string;
 }
 export interface PatternFieldValidationRuleConfig {
     type: 'pattern';
@@ -48,6 +51,8 @@ export interface PatternFieldValidationRuleConfig {
     /** Shown for a pattern that compiles but is refused because matching it
      *  could hang the page. Falls back to `invalidError`. */
     unsafeError?: string;
+    /** Shown under this rule while another rule blocks it. */
+    exclusiveRulesExplanation?: string;
 }
 export type FieldValidationRuleConfig = RequiredFieldValidationRuleConfig | CharactersLimitFieldValidationRuleConfig | SpecificValuesFieldValidationRuleConfig | PatternFieldValidationRuleConfig;
 export type FieldValidationRule = FieldValidationRuleConfig['type'];

package/dist/types/types/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/types/validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/types/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,eAAe,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,cAAc,EAAE,aAAa,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,WAAW,iCAAiC;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wCAAwC;IACvD,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,uCAAuC;IACtD,IAAI,EAAE,gBAAgB,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,gCAAgC;IAC/C,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB;6DACyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,MAAM,yBAAyB,GACjC,iCAAiC,GACjC,wCAAwC,GACxC,uCAAuC,GACvC,gCAAgC,CAAC;AAErC,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAChC;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb,GACD;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAChD;IACE,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,OAAO,GAAG,WAAW,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB,GACD;IACE,IAAI,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACvD,IAAI,EAAE,gBAAgB,CAAC;CACxB,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,gBAAgB,GAAG,eAAe,CAAA;CAAE,CAAC;AAElE,MAAM,MAAM,mBAAmB,GAAG,OAAO,CACvC,sBAAsB,GACpB,6BAA6B,GAC7B,4BAA4B,GAC5B,qBAAqB,CACxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/patterns-fields",
-  "version": "1.95.0",
+  "version": "1.96.0",
   "license": "UNLICENSED",
   "author": {
     "name": "Kobi",
@@ -124,7 +124,7 @@
     "@wix/atlas": "^1.0.35",
     "@wix/data": "^1.0.323",
     "@wix/media": "^1.0.231",
-    "@wix/patterns-fields-utils": "1.76.0",
+    "@wix/patterns-fields-utils": "1.77.0",
     "@wix/rich-content": "1.0.37",
     "@wix/sdk": "^1.17.2",
     "@wix/wix-ui-icons-common": "^3.189.0",
@@ -152,7 +152,7 @@
     "@types/lodash": "^4.17.20",
     "@types/react": "^16.14.68",
     "@wix/babel-cli": "^1.11.0",
-    "@wix/bex-core": "2.373.0",
+    "@wix/bex-core": "2.374.0",
     "@wix/design-system": "^1.319.0",
     "@wix/eslint-config-yoshi": "^6.74.0",
     "@wix/jest-yoshi-preset": "^6.74.0",
@@ -212,5 +212,5 @@
       "optional": true
     }
   },
-  "falconPackageHash": "9c2ac5fb91ff026ebe41371d62f5779cf05f0e651e888457449fe55d"
+  "falconPackageHash": "5cd0bb88af543328ef37718c741e23a8661d02f7f12673a9410dde77"
 }

package/src/__tests__/components/address/address-input.driver.tsx

@@ -8,6 +8,7 @@ import { AddressInputUniDriver } from '../../../components/address/input/address
 import { uniTestkitFactoryCreator } from '@wix/wix-ui-test-utils/testing-library';
 import { flush } from '@wix/bex-core/testkit';
 import { PatternsFieldsTestProvider } from '../../../testkit/patterns-fields-test-provider';
+import { InputUniDriver } from '@wix/design-system/dist/testkit/unidriver';
 
 const SEARCH_DEBOUNCE_MS = 250;
 
@@ -36,10 +37,19 @@ export class AddressInputDriver {
 
   waitForDebounce() {
     return act(async () => {
+      // Legacy timers do not advance the clock lodash's debounce reads.
+      jest.spyOn(Date, 'now').mockReturnValue(Date.now() + SEARCH_DEBOUNCE_MS);
       jest.advanceTimersByTime(SEARCH_DEBOUNCE_MS);
     });
   }
 
+  pressEscape() {
+    return uniTestkitFactoryCreator(InputUniDriver)({
+      wrapper: this.renderResult.container,
+      dataHook: 'address-input',
+    }).keyDown({ key: 'Escape' });
+  }
+
   render(props: AddressInputProps) {
     this._renderResult = render(
       <AddressInput {...props} atlasService={this._mockService} />,
@@ -47,7 +57,13 @@ export class AddressInputDriver {
     );
   }
 
+  unmount() {
+    this.renderResult.unmount();
+  }
+
   async flush(iterations?: number) {
-    return flush(iterations);
+    await act(async () => {
+      await flush(iterations);
+    });
   }
 }

package/src/__tests__/components/address/address-input.spec.tsx

@@ -6,7 +6,22 @@ import {
   createAtlasServiceMock,
 } from '../../../services/atlas/atlas-service-mock';
 
+const mockPredict = jest.fn();
+const mockGetPlace = jest.fn();
+
+jest.mock('@wix/atlas', () => ({
+  autocomplete: { predict: (...args: unknown[]) => mockPredict(...args) },
+  places: { getPlace: (...args: unknown[]) => mockGetPlace(...args) },
+  location: { search: jest.fn() },
+}));
+
 describe('AddressInput', () => {
+  beforeEach(() => {
+    jest.useFakeTimers('legacy');
+    jest.clearAllMocks();
+  });
+  afterEach(() => jest.restoreAllMocks());
+
   const mockAddress: Address = {
     formatted: 'Halimon 25, Tel Mond, IL',
     city: 'Tel Mond',
@@ -16,12 +31,16 @@ describe('AddressInput', () => {
   const setup = async ({
     mockAtlasService,
     initialValue,
+    onChange,
+    onSelectAddress,
   }: {
     mockAtlasService?: AtlasService;
     initialValue?: Address;
+    onChange?: (value?: Address) => void;
+    onSelectAddress?: () => void;
   } = {}) => {
     const driver = new AddressInputDriver({ service: mockAtlasService });
-    driver.render({ value: initialValue });
+    driver.render({ value: initialValue, onChange, onSelectAddress });
 
     await driver.flush();
     return { driver };
@@ -72,4 +91,191 @@ describe('AddressInput', () => {
     expect(await driver.addressInput.getInputValue()).toBe('Test address');
     expect(await driver.addressInput.getAmountOfItems()).toBe(0);
   });
+
+  it('resolves the selected prediction before returning the complete address', async () => {
+    const onChange = jest.fn();
+    const onSelectAddress = jest.fn();
+    const service: AtlasService = {
+      searchAddress: jest.fn(),
+      predictAddress: jest.fn().mockResolvedValue([
+        {
+          searchId: 'place-1',
+          description: mockAddress.formatted,
+          textStructure: {
+            mainText: 'Halimon 25',
+            secondaryText: 'Tel Mond, IL',
+          },
+        },
+      ]),
+      getAddress: jest.fn().mockResolvedValue(mockAddress),
+    };
+    const { driver } = await setup({
+      mockAtlasService: service,
+      onChange,
+      onSelectAddress,
+    });
+    await driver.addressInput.clickInput();
+    await driver.addressInput.enterText('Halimon');
+    await driver.waitForDebounce();
+
+    expect(await driver.addressInput.getItemMainLabelAt(0)).toBe('Halimon 25');
+    expect(await driver.addressInput.getItemSecondaryLabelAt(0)).toBe(
+      'Tel Mond, IL',
+    );
+    expect(onChange).not.toHaveBeenCalled();
+
+    await driver.addressInput.clickAtOption(0);
+    await driver.flush();
+
+    expect(service.getAddress).toHaveBeenCalledWith('place-1');
+    expect(service.searchAddress).not.toHaveBeenCalled();
+    expect(onChange).toHaveBeenCalledWith(mockAddress);
+    expect(onSelectAddress).toHaveBeenCalledTimes(1);
+    expect(await driver.addressInput.getInputValue()).toBe(
+      mockAddress.formatted,
+    );
+  });
+
+  it('notifies the owner when the input is emptied', async () => {
+    const onChange = jest.fn();
+    const { driver } = await setup({ initialValue: mockAddress, onChange });
+
+    await driver.addressInput.enterText('');
+    await driver.flush();
+
+    expect(onChange).toHaveBeenCalledWith(undefined);
+    expect(await driver.addressInput.getInputValue()).toBe('');
+  });
+
+  it('uses Atlas predictions and place details by default', async () => {
+    mockPredict.mockResolvedValue({
+      predictions: [
+        {
+          searchId: 'atlas-place',
+          description: mockAddress.formatted,
+          textStructure: {
+            mainText: 'Halimon 25',
+            secondaryText: 'Tel Mond, IL',
+          },
+        },
+      ],
+    });
+    mockGetPlace.mockResolvedValue({ place: { address: mockAddress } });
+    const onChange = jest.fn();
+    const { driver } = await setup({ onChange });
+    await driver.addressInput.clickInput();
+    await driver.addressInput.enterText('Halimon');
+    await driver.waitForDebounce();
+    await driver.addressInput.clickAtOption(0);
+    await driver.flush();
+
+    expect(mockPredict).toHaveBeenCalledWith('Halimon');
+    expect(mockGetPlace).toHaveBeenCalledWith('atlas-place');
+    expect(onChange).toHaveBeenCalledWith(mockAddress);
+  });
+
+  it('keeps suggestions for the latest query when an older search finishes later', async () => {
+    let resolveFirst: (addresses: Address[]) => void = () => {};
+    const first = new Promise<Address[]>((resolve) => {
+      resolveFirst = resolve;
+    });
+    const newerAddress = { formatted: 'New York, NY, USA' };
+    const service: AtlasService = {
+      searchAddress: jest
+        .fn()
+        .mockReturnValueOnce(first)
+        .mockResolvedValueOnce([newerAddress]),
+    };
+    const { driver } = await setup({ mockAtlasService: service });
+    await driver.addressInput.clickInput();
+    await driver.addressInput.enterText('New');
+    await driver.waitForDebounce();
+    await driver.addressInput.enterText('New York');
+    await driver.waitForDebounce();
+    resolveFirst([mockAddress]);
+    await driver.flush();
+
+    expect(await driver.addressInput.getItemMainLabelAt(0)).toBe('New York');
+    expect(await driver.addressInput.getAmountOfItems()).toBe(1);
+  });
+
+  it('does not restore suggestions when a search completes after clearing', async () => {
+    let resolveSearch: (addresses: Address[]) => void = () => {};
+    const result = new Promise<Address[]>((resolve) => {
+      resolveSearch = resolve;
+    });
+    const { driver } = await setup({
+      mockAtlasService: { searchAddress: () => result },
+    });
+    await driver.addressInput.clickInput();
+    await driver.addressInput.enterText('Halimon');
+    await driver.waitForDebounce();
+    await driver.addressInput.enterText('');
+    resolveSearch([mockAddress]);
+    await driver.flush();
+
+    expect(await driver.addressInput.getAmountOfItems()).toBe(0);
+    expect(await driver.addressInput.getInputValue()).toBe('');
+  });
+
+  it('does not commit a place lookup that finishes after the input unmounts', async () => {
+    let resolveAddress: (address: Address) => void = () => {};
+    const result = new Promise<Address>((resolve) => {
+      resolveAddress = resolve;
+    });
+    const onChange = jest.fn();
+    const onSelectAddress = jest.fn();
+    const service: AtlasService = {
+      searchAddress: jest.fn(),
+      predictAddress: async () => [
+        { searchId: 'place-1', description: mockAddress.formatted },
+      ],
+      getAddress: () => result,
+    };
+    const { driver } = await setup({
+      mockAtlasService: service,
+      onChange,
+      onSelectAddress,
+    });
+    await driver.addressInput.clickInput();
+    await driver.addressInput.enterText('Halimon');
+    await driver.waitForDebounce();
+    await driver.addressInput.clickAtOption(0);
+    driver.unmount();
+    resolveAddress(mockAddress);
+    await driver.flush();
+
+    expect(onChange).not.toHaveBeenCalled();
+    expect(onSelectAddress).not.toHaveBeenCalled();
+  });
+
+  it('does not replace the address when a place lookup finishes after Escape', async () => {
+    let resolveAddress: (address: Address) => void = () => {};
+    const result = new Promise<Address>((resolve) => {
+      resolveAddress = resolve;
+    });
+    const onChange = jest.fn();
+    const service: AtlasService = {
+      searchAddress: jest.fn(),
+      predictAddress: async () => [
+        { searchId: 'new-place', description: 'New York, NY, USA' },
+      ],
+      getAddress: () => result,
+    };
+    const { driver } = await setup({
+      mockAtlasService: service,
+      initialValue: mockAddress,
+      onChange,
+    });
+    await driver.addressInput.clickInput();
+    await driver.addressInput.enterText('New York');
+    await driver.waitForDebounce();
+    await driver.addressInput.clickAtOption(0);
+    await driver.pressEscape();
+
+    resolveAddress({ formatted: 'New York, NY, USA' });
+    await driver.flush();
+
+    expect(onChange).not.toHaveBeenCalled();
+  });
 });

package/src/__tests__/components/field-validation-settings/field-validation-settings-input.spec.tsx

@@ -30,6 +30,8 @@ const charactersLimitRule: FieldValidationRuleConfig = {
   separator: 'and',
   outOfBoundsError: (min, max) => `Enter a value from ${min} to ${max}.`,
   maxBelowMinError: 'Maximum must not be below minimum.',
+  exclusiveRulesExplanation:
+    "You can't limit character count for specific values.",
 };
 
 const specificValuesRule: FieldValidationRuleConfig = {
@@ -49,6 +51,8 @@ const patternRule: FieldValidationRuleConfig = {
   tooltip: 'Pattern tooltip',
   inputLabel: 'Regular expression',
   invalidError: 'Enter a valid regular expression.',
+  exclusiveRulesExplanation:
+    "You can't add pattern validation for specific values.",
 };
 
 const allRules = [
@@ -68,6 +72,7 @@ interface RenderInputOptions {
   readOnly?: boolean;
   invalid?: boolean;
   disabledRules?: readonly FieldValidationRuleConfig['type'][];
+  exclusiveSpecificValues?: boolean;
 }
 
 const renderInput = (
@@ -77,6 +82,7 @@ const renderInput = (
     readOnly,
     invalid,
     disabledRules,
+    exclusiveSpecificValues,
   }: RenderInputOptions = {},
 ) => {
   const onChange = jest.fn<void, [FieldValidationSettingsValue]>();
@@ -91,6 +97,7 @@ const renderInput = (
         readOnly={readOnly}
         invalid={invalid}
         disabledRules={disabledRules}
+        exclusiveSpecificValues={exclusiveSpecificValues}
         onChange={(nextData) => {
           onChange(nextData);
           setData(nextData);
@@ -337,6 +344,86 @@ describe('FieldValidationSettingsInput', () => {
     expect(await driver.getPatternToggle().isDisabled()).toBe(true);
   });
 
+  it('explains exclusivity under each rule that specific values block', async () => {
+    const { driver } = renderInput({ specificValues: [] });
+
+    expect(
+      await driver.getExclusiveRulesExplanation('characters-limit').text(),
+    ).toBe("You can't limit character count for specific values.");
+    expect(await driver.getExclusiveRulesExplanation('pattern').text()).toBe(
+      "You can't add pattern validation for specific values.",
+    );
+    expect(
+      await driver.getExclusiveRulesExplanation('specific-values').exists(),
+    ).toBe(false);
+  });
+
+  it('explains exclusivity under specific values when a character limit blocks it', async () => {
+    const { driver } = renderInput({ charactersLimit: {} });
+
+    expect(
+      await driver.getExclusiveRulesExplanation('specific-values').text(),
+    ).toBe('Disable the active rule first.');
+    expect(
+      await driver.getExclusiveRulesExplanation('characters-limit').exists(),
+    ).toBe(false);
+  });
+
+  it('falls back to the specific-values explanation exactly once for legacy configs', async () => {
+    const { driver, container } = renderInput(
+      { specificValues: [] },
+      {
+        rules: [
+          { ...charactersLimitRule, exclusiveRulesExplanation: undefined },
+          specificValuesRule,
+          { ...patternRule, exclusiveRulesExplanation: undefined },
+        ],
+      },
+    );
+
+    expect(await driver.hasExclusiveRulesExplanation()).toBe(true);
+    expect(
+      Array.from(
+        container.querySelectorAll('[data-hook$="exclusive-help"]'),
+      ).map((node) => node.textContent),
+    ).toEqual(['Disable the active rule first.']);
+  });
+
+  it('omits an exclusivity explanation when no rule config supplies one', async () => {
+    const { driver } = renderInput(
+      { specificValues: [] },
+      {
+        rules: [
+          { ...charactersLimitRule, exclusiveRulesExplanation: undefined },
+          { ...specificValuesRule, exclusiveRulesExplanation: undefined },
+        ],
+      },
+    );
+
+    expect(await driver.getCharactersLimitToggle().isDisabled()).toBe(true);
+    expect(await driver.hasExclusiveRulesExplanation()).toBe(false);
+  });
+
+  it('keeps every rule toggle enabled when specific values are not exclusive', async () => {
+    const { driver } = renderInput(
+      { specificValues: [] },
+      { exclusiveSpecificValues: false },
+    );
+
+    expect(await driver.getSpecificValuesToggle().isDisabled()).toBe(false);
+    expect(await driver.getCharactersLimitToggle().isDisabled()).toBe(false);
+    expect(await driver.getPatternToggle().isDisabled()).toBe(false);
+  });
+
+  it('does not explain exclusivity when specific values are not exclusive', async () => {
+    const { driver } = renderInput(
+      { charactersLimit: {} },
+      { exclusiveSpecificValues: false },
+    );
+
+    expect(await driver.hasExclusiveRulesExplanation()).toBe(false);
+  });
+
   it('keeps active conflicting rules enabled so loaded data can be repaired', async () => {
     const { driver, onChange } = renderInput({
       charactersLimit: {},

package/src/__tests__/components/url/form-url.spec.tsx

@@ -109,6 +109,69 @@ describe('FormUrl field', () => {
     expect(await driver.tk.hasError()).toBe(false);
   });
 
+  it('shows a min-length error when the URL is shorter than minLength', async () => {
+    const driver = setup({
+      field: makeField({
+        type: 'URL',
+        validation: { required: false, stringLengthRange: { minLength: 25 } },
+      }),
+    });
+
+    await driver.tk.enterText('https://wix.com');
+
+    expect(await driver.tk.hasError()).toBe(true);
+    expect(await driver.tk.getErrorMessage()).toBe(
+      'cairo.fieldValidation.minCharacter{charMin=25}',
+    );
+  });
+
+  it('shows a max-length error when the URL is longer than maxLength', async () => {
+    const driver = setup({
+      field: makeField({
+        type: 'URL',
+        validation: { required: false, stringLengthRange: { maxLength: 20 } },
+      }),
+    });
+
+    await driver.tk.enterText('https://example.com/a/very/long/path');
+
+    expect(await driver.tk.hasError()).toBe(true);
+    expect(await driver.tk.getErrorMessage()).toBe(
+      'cairo.fieldValidation.maxCharacter{charMax=20}',
+    );
+  });
+
+  it('accepts a URL inside the allowed length range', async () => {
+    const driver = setup({
+      field: makeField({
+        type: 'URL',
+        validation: {
+          required: false,
+          stringLengthRange: { minLength: 10, maxLength: 40 },
+        },
+      }),
+    });
+
+    await driver.tk.enterText('https://example.com');
+
+    expect(await driver.tk.hasError()).toBe(false);
+  });
+
+  it('reports the malformed-URL error before the length error', async () => {
+    const driver = setup({
+      field: makeField({
+        type: 'URL',
+        validation: { required: false, stringLengthRange: { minLength: 25 } },
+      }),
+    });
+
+    await driver.tk.enterText('not a url');
+
+    expect(await driver.tk.getErrorMessage()).toBe(
+      'cairo.customFields.url-input.error',
+    );
+  });
+
   it('reports the malformed-URL error before the pattern error', async () => {
     const driver = setup({
       field: makeField({

package/src/__tests__/components/video/form-video.spec.tsx

@@ -2,6 +2,7 @@ import '../../../testkit/test-polyfills';
 
 import type { Field } from '@wix/bex-core';
 
+import { Z_INDEX_MODAL_POPOVER } from '../../../components/common';
 import { FormVideo } from '../../../components/video/form-video';
 import { FormVideoDriver } from '../../../components/video/form-video.driver';
 import { FormFieldDriver, makeField } from '../../form-field.driver';
@@ -82,6 +83,22 @@ describe('FormVideo field', () => {
     );
   });
 
+  it('raises the more-actions menu above modal content', async () => {
+    const field = makeField({ type: 'VIDEO' });
+    const driver = setup({ field, initialValue: VALID_VIDEO_URI });
+
+    await driver.tk.clickMore();
+
+    const deleteAction = document.querySelector(
+      `[data-hook="video-delete-${field.id}"]`,
+    );
+    expect(deleteAction).toBeTruthy();
+    expect(deleteAction!.closest('[data-zindex]')).toHaveAttribute(
+      'data-zindex',
+      String(Z_INDEX_MODAL_POPOVER),
+    );
+  });
+
   // The empty state is the only one that can fail `required`, so its add
   // button is what react-hook-form should land on.
   it('focuses the add button when a required value blocks submit', async () => {

package/src/__tests__/exports/controlled-inputs.spec.tsx

@@ -488,6 +488,52 @@ describe('controlled inputs', () => {
     expect(onChange).toHaveBeenCalledWith(undefined);
   });
 
+  // The testkit factory resolves a dataHook once, when the driver is built, so
+  // a driver made before the click keeps answering about the old render. Each
+  // assertion below uses a driver created after the render it describes.
+  it('shows the audio loader inside the add button while the picker is open', async () => {
+    let resolvePick: (value: unknown) => void = () => {};
+    const openMediaManager = jest.fn().mockImplementation(
+      () =>
+        new Promise((resolve) => {
+          resolvePick = resolve;
+        }),
+    );
+    const { container } = render(
+      <ControlledAudioInput
+        data={undefined}
+        onChange={jest.fn()}
+        dataHook="audio-loading"
+      />,
+      { wrapper: withMediaManager(openMediaManager) },
+    );
+
+    await getInput(container, 'audio-loading').audio.clickAddButton();
+    await act(async () => {});
+
+    expect(openMediaManager).toHaveBeenCalledTimes(1);
+
+    const fieldBox = container.querySelector<HTMLElement>(
+      '[data-hook="audio-loading"]',
+    );
+    expect(fieldBox).not.toBeNull();
+    expect(
+      fieldBox!.querySelector('[data-hook="fromAudioInput.loader"]'),
+    ).not.toBeNull();
+
+    const loading = getInput(container, 'audio-loading').audio;
+    expect(await loading.isLoading()).toBe(true);
+    expect(await loading.getAddButtonText()).toBe('');
+
+    await act(async () => {
+      resolvePick({ items: [] });
+    });
+
+    const settled = getInput(container, 'audio-loading').audio;
+    expect(await settled.isLoading()).toBe(false);
+    expect(await settled.getAddButtonText()).toBe('CMS.audio.button.add');
+  });
+
   it('disables the audio replace and delete actions when readOnly', async () => {
     const { container } = render(
       <ControlledAudioInput