@base-ui/react 1.4.0 → 1.5.0

package/{composite → internals/composite}/root/useCompositeRoot.js

@@ -12,7 +12,7 @@ var _useStableCallback = require("@base-ui/utils/useStableCallback");
 var _useMergedRefs = require("@base-ui/utils/useMergedRefs");
 var _composite = require("../composite");
 var _constants = require("../constants");
-var _utils = require("../../floating-ui-react/utils");
+var _utils = require("../../../floating-ui-react/utils");
 const EMPTY_ARRAY = [];
 function useCompositeRoot(params) {
   const {
@@ -77,7 +77,7 @@ function useCompositeRoot(params) {
       target.setSelectionRange(0, target.value.length ?? 0);
     },
     onKeyDown(event) {
-      const RELEVANT_KEYS = enableHomeAndEndKeys ? _composite.ALL_KEYS : _composite.ARROW_KEYS;
+      const RELEVANT_KEYS = enableHomeAndEndKeys ? _composite.COMPOSITE_KEYS : _composite.ARROW_KEYS;
       if (!RELEVANT_KEYS.has(event.key)) {
         return;
       }

package/{esm/utils → internals}/constants.d.ts

@@ -1,3 +1,4 @@
+import type * as React from 'react';
 export declare const TYPEAHEAD_RESET_MS = 500;
 export declare const PATIENT_CLICK_THRESHOLD = 500;
 export declare const DISABLED_TRANSITIONS_STYLE: {
@@ -5,7 +6,6 @@ export declare const DISABLED_TRANSITIONS_STYLE: {
     transition: string;
   };
 };
-export { EMPTY_OBJECT, EMPTY_ARRAY } from '@base-ui/utils/empty';
 export declare const CLICK_TRIGGER_IDENTIFIER = "data-base-ui-click-trigger";
 export declare const BASE_UI_SWIPE_IGNORE_ATTRIBUTE = "data-base-ui-swipe-ignore";
 export declare const LEGACY_SWIPE_IGNORE_ATTRIBUTE = "data-swipe-ignore";

package/{utils → internals}/constants.js

@@ -3,21 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.DROPDOWN_COLLISION_AVOIDANCE = exports.DISABLED_TRANSITIONS_STYLE = exports.CLICK_TRIGGER_IDENTIFIER = exports.BASE_UI_SWIPE_IGNORE_SELECTOR = exports.BASE_UI_SWIPE_IGNORE_ATTRIBUTE = void 0;
-Object.defineProperty(exports, "EMPTY_ARRAY", {
-  enumerable: true,
-  get: function () {
-    return _empty.EMPTY_ARRAY;
-  }
-});
-Object.defineProperty(exports, "EMPTY_OBJECT", {
-  enumerable: true,
-  get: function () {
-    return _empty.EMPTY_OBJECT;
-  }
-});
-exports.ownerVisuallyHidden = exports.TYPEAHEAD_RESET_MS = exports.POPUP_COLLISION_AVOIDANCE = exports.PATIENT_CLICK_THRESHOLD = exports.LEGACY_SWIPE_IGNORE_SELECTOR = exports.LEGACY_SWIPE_IGNORE_ATTRIBUTE = void 0;
-var _empty = require("@base-ui/utils/empty");
+exports.ownerVisuallyHidden = exports.TYPEAHEAD_RESET_MS = exports.POPUP_COLLISION_AVOIDANCE = exports.PATIENT_CLICK_THRESHOLD = exports.LEGACY_SWIPE_IGNORE_SELECTOR = exports.LEGACY_SWIPE_IGNORE_ATTRIBUTE = exports.DROPDOWN_COLLISION_AVOIDANCE = exports.DISABLED_TRANSITIONS_STYLE = exports.CLICK_TRIGGER_IDENTIFIER = exports.BASE_UI_SWIPE_IGNORE_SELECTOR = exports.BASE_UI_SWIPE_IGNORE_ATTRIBUTE = void 0;
 const TYPEAHEAD_RESET_MS = exports.TYPEAHEAD_RESET_MS = 500;
 const PATIENT_CLICK_THRESHOLD = exports.PATIENT_CLICK_THRESHOLD = 500;
 const DISABLED_TRANSITIONS_STYLE = exports.DISABLED_TRANSITIONS_STYLE = {

package/{utils → internals}/createBaseUIEventDetails.d.ts

@@ -31,6 +31,8 @@ interface ReasonToEventMap {
   [REASONS.cancelOpen]: MouseEvent;
   [REASONS.siblingOpen]: Event;
   [REASONS.disabled]: Event;
+  [REASONS.missing]: Event;
+  [REASONS.initial]: Event;
   [REASONS.imperativeAction]: Event;
   [REASONS.windowResize]: UIEvent;
 }

package/{utils → internals}/createBaseUIEventDetails.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.createChangeEventDetails = createChangeEventDetails;
 exports.createGenericEventDetails = createGenericEventDetails;
-var _constants = require("./constants");
+var _empty = require("@base-ui/utils/empty");
 var _reasons = require("./reasons");
 /**
  * Maps a change `reason` string to the corresponding native event type.
@@ -26,7 +26,7 @@ var _reasons = require("./reasons");
 function createChangeEventDetails(reason, event, trigger, customProperties) {
   let canceled = false;
   let allowPropagation = false;
-  const custom = customProperties ?? _constants.EMPTY_OBJECT;
+  const custom = customProperties ?? _empty.EMPTY_OBJECT;
   const details = {
     reason,
     event: event ?? new Event('base-ui'),
@@ -48,7 +48,7 @@ function createChangeEventDetails(reason, event, trigger, customProperties) {
   return details;
 }
 function createGenericEventDetails(reason, event, customProperties) {
-  const custom = customProperties ?? _constants.EMPTY_OBJECT;
+  const custom = customProperties ?? _empty.EMPTY_OBJECT;
   const details = {
     reason,
     event: event ?? new Event('base-ui'),

package/internals/csp-context/index.d.ts

@@ -0,0 +1,2 @@
+export { CSPContext, useCSPContext } from "./CSPContext.js";
+export type { CSPContextValue } from "./CSPContext.js";

package/internals/csp-context/index.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "CSPContext", {
+  enumerable: true,
+  get: function () {
+    return _CSPContext.CSPContext;
+  }
+});
+Object.defineProperty(exports, "useCSPContext", {
+  enumerable: true,
+  get: function () {
+    return _CSPContext.useCSPContext;
+  }
+});
+var _CSPContext = require("./CSPContext");

package/internals/direction-context/index.d.ts

@@ -0,0 +1,2 @@
+export { DirectionContext, useDirection } from "./DirectionContext.js";
+export type { TextDirection, DirectionContext as DirectionContextType } from "./DirectionContext.js";

package/internals/direction-context/index.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DirectionContext", {
+  enumerable: true,
+  get: function () {
+    return _DirectionContext.DirectionContext;
+  }
+});
+Object.defineProperty(exports, "useDirection", {
+  enumerable: true,
+  get: function () {
+    return _DirectionContext.useDirection;
+  }
+});
+var _DirectionContext = require("./DirectionContext");

package/{field/utils → internals/field-constants}/constants.d.ts

@@ -1,4 +1,4 @@
-import type { FieldRootState } from "../root/FieldRoot.js";
+import type { FieldRootState } from "../../field/root/FieldRoot.js";
 export declare const DEFAULT_VALIDITY_STATE: {
   badInput: boolean;
   customError: boolean;

package/{field/utils → internals/field-constants}/constants.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.fieldValidityMapping = exports.DEFAULT_VALIDITY_STATE = exports.DEFAULT_FIELD_STATE_ATTRIBUTES = exports.DEFAULT_FIELD_ROOT_STATE = void 0;
-var _FieldControlDataAttributes = require("../control/FieldControlDataAttributes");
+var _FieldControlDataAttributes = require("../../field/control/FieldControlDataAttributes");
 const DEFAULT_VALIDITY_STATE = exports.DEFAULT_VALIDITY_STATE = {
   badInput: false,
   customError: false,

package/internals/field-constants/index.d.ts

@@ -0,0 +1 @@
+export { DEFAULT_VALIDITY_STATE, DEFAULT_FIELD_STATE_ATTRIBUTES, DEFAULT_FIELD_ROOT_STATE, fieldValidityMapping } from "./constants.js";

package/internals/field-constants/index.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "DEFAULT_FIELD_ROOT_STATE", {
+  enumerable: true,
+  get: function () {
+    return _constants.DEFAULT_FIELD_ROOT_STATE;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_FIELD_STATE_ATTRIBUTES", {
+  enumerable: true,
+  get: function () {
+    return _constants.DEFAULT_FIELD_STATE_ATTRIBUTES;
+  }
+});
+Object.defineProperty(exports, "DEFAULT_VALIDITY_STATE", {
+  enumerable: true,
+  get: function () {
+    return _constants.DEFAULT_VALIDITY_STATE;
+  }
+});
+Object.defineProperty(exports, "fieldValidityMapping", {
+  enumerable: true,
+  get: function () {
+    return _constants.fieldValidityMapping;
+  }
+});
+var _constants = require("./constants");

package/internals/field-register-control/index.d.ts

@@ -0,0 +1,3 @@
+export { useRegisterFieldControl } from "./useRegisterFieldControl.js";
+export { useFieldControlRegistration } from "./useFieldControlRegistration.js";
+export type { FieldControlRegistration, UseFieldControlRegistrationParameters } from "./useFieldControlRegistration.js";

package/internals/field-register-control/index.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "useFieldControlRegistration", {
+  enumerable: true,
+  get: function () {
+    return _useFieldControlRegistration.useFieldControlRegistration;
+  }
+});
+Object.defineProperty(exports, "useRegisterFieldControl", {
+  enumerable: true,
+  get: function () {
+    return _useRegisterFieldControl.useRegisterFieldControl;
+  }
+});
+var _useRegisterFieldControl = require("./useRegisterFieldControl");
+var _useFieldControlRegistration = require("./useFieldControlRegistration");

package/{field/root → internals/field-register-control}/useFieldControlRegistration.d.ts

@@ -1,9 +1,9 @@
 import * as React from 'react';
-import type { FieldValidityData } from "./FieldRoot.js";
+import type { FieldValidityData } from "../../field/root/FieldRoot.js";
 export interface FieldControlRegistration {
   controlRef: React.RefObject<any>;
-  getValue?: (() => unknown) | undefined;
   id: string | undefined;
+  getValue?: (() => unknown) | undefined;
   value: unknown;
 }
 export declare function useFieldControlRegistration(params: UseFieldControlRegistrationParameters): (source: symbol, registration: FieldControlRegistration | undefined) => void;
@@ -12,6 +12,7 @@ export interface UseFieldControlRegistrationParameters {
   invalid: boolean;
   markedDirtyRef: React.RefObject<boolean>;
   name: string | undefined;
+  setRegisteredFieldId: (id: string | undefined) => void;
   setValidityData: React.Dispatch<React.SetStateAction<FieldValidityData>>;
   validityData: FieldValidityData;
 }

package/{field/root → internals/field-register-control}/useFieldControlRegistration.js

@@ -7,17 +7,17 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.useFieldControlRegistration = useFieldControlRegistration;
 var React = _interopRequireWildcard(require("react"));
-var ReactDOM = _interopRequireWildcard(require("react-dom"));
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _useStableCallback = require("@base-ui/utils/useStableCallback");
-var _getCombinedFieldValidityData = require("../utils/getCombinedFieldValidityData");
-var _FormContext = require("../../form/FormContext");
+var _getCombinedFieldValidityData = require("../../field/utils/getCombinedFieldValidityData");
+var _FormContext = require("../form-context/FormContext");
 function useFieldControlRegistration(params) {
   const {
     commit,
     invalid,
     markedDirtyRef,
     name,
+    setRegisteredFieldId,
     setValidityData,
     validityData
   } = params;
@@ -27,7 +27,7 @@ function useFieldControlRegistration(params) {
   const activeFieldControlSourceRef = React.useRef(null);
   const registrationRef = React.useRef(null);
   const fallbackControlRef = React.useRef(null);
-  const getValue = (0, _useStableCallback.useStableCallback)(() => {
+  const getValueForForm = (0, _useStableCallback.useStableCallback)(() => {
     const registration = registrationRef.current;
     if (!registration) {
       return undefined;
@@ -37,22 +37,17 @@ function useFieldControlRegistration(params) {
     }
     return registration.value;
   });
-  const validate = (0, _useStableCallback.useStableCallback)((flushSync = true) => {
+  const validate = (0, _useStableCallback.useStableCallback)(() => {
     const registration = registrationRef.current;
     if (!registration) {
       return;
     }
     let nextValue = registration.value;
     if (nextValue === undefined) {
-      nextValue = getValue();
+      nextValue = getValueForForm();
     }
     markedDirtyRef.current = true;
-    if (!flushSync) {
-      commit(nextValue);
-    } else {
-      // Synchronously update the validity state so the submit event can be prevented.
-      ReactDOM.flushSync(() => commit(nextValue));
-    }
+    commit(nextValue);
   });
   function refreshRegistration() {
     const registration = registrationRef.current;
@@ -60,7 +55,7 @@ function useFieldControlRegistration(params) {
       return;
     }
     formRef.current.fields.set(registration.id, {
-      getValue,
+      getValue: getValueForForm,
       name,
       controlRef: registration.controlRef ?? fallbackControlRef,
       validityData: (0, _getCombinedFieldValidityData.getCombinedFieldValidityData)(validityData, invalid),
@@ -79,7 +74,7 @@ function useFieldControlRegistration(params) {
     }
     let initialValue = registration.value;
     if (initialValue === undefined) {
-      initialValue = getValue();
+      initialValue = getValueForForm();
     }
     if (validityData.initialValue === null && initialValue !== null) {
       setValidityData(prev => ({
@@ -94,13 +89,13 @@ function useFieldControlRegistration(params) {
       return;
     }
     formRef.current.fields.set(registration.id, {
-      getValue,
+      getValue: getValueForForm,
       name,
       controlRef: registration.controlRef ?? fallbackControlRef,
       validityData: (0, _getCombinedFieldValidityData.getCombinedFieldValidityData)(validityData, invalid),
       validate
     });
-  }, [formRef, getValue, invalid, name, validate, validityData]);
+  }, [formRef, getValueForForm, invalid, name, validate, validityData]);
   (0, _useIsoLayoutEffect.useIsoLayoutEffect)(() => {
     const fields = formRef.current.fields;
     return () => {
@@ -116,12 +111,14 @@ function useFieldControlRegistration(params) {
         activeFieldControlSourceRef.current = null;
         deleteRegistration();
         registrationRef.current = null;
+        setRegisteredFieldId(undefined);
       }
       return;
     }
     const previousId = registrationRef.current?.id;
     activeFieldControlSourceRef.current = source;
     registrationRef.current = registration;
+    setRegisteredFieldId(registration.id);
     if (previousId && previousId !== registration.id) {
       deleteRegistration(previousId);
     }

package/internals/field-register-control/useRegisterFieldControl.d.ts

@@ -0,0 +1,2 @@
+import type { FieldControlRegistration } from "./useFieldControlRegistration.js";
+export declare function useRegisterFieldControl(controlRef: FieldControlRegistration['controlRef'], id: FieldControlRegistration['id'], value: FieldControlRegistration['value'], getFormValueOverride?: FieldControlRegistration['getValue'], enabled?: boolean): void;

package/{field/root → internals/field-register-control}/useRegisterFieldControl.js

@@ -8,14 +8,8 @@ Object.defineProperty(exports, "__esModule", {
 exports.useRegisterFieldControl = useRegisterFieldControl;
 var React = _interopRequireWildcard(require("react"));
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
-var _FieldRootContext = require("./FieldRootContext");
-function useRegisterFieldControl(controlRef, params) {
-  const {
-    enabled = true,
-    getValue,
-    id,
-    value
-  } = params;
+var _FieldRootContext = require("../field-root-context/FieldRootContext");
+function useRegisterFieldControl(controlRef, id, value, getFormValueOverride, enabled = true) {
   const {
     registerFieldControl
   } = (0, _FieldRootContext.useFieldRootContext)();
@@ -28,14 +22,15 @@ function useRegisterFieldControl(controlRef, params) {
     if (!source || !enabled) {
       return undefined;
     }
-    registerFieldControl(source, {
+    const registration = {
       controlRef,
-      getValue,
+      getValue: getFormValueOverride,
       id,
       value
-    });
+    };
+    registerFieldControl(source, registration);
     return () => {
       registerFieldControl(source, undefined);
     };
-  }, [controlRef, enabled, getValue, id, registerFieldControl, value]);
+  }, [controlRef, enabled, getFormValueOverride, id, registerFieldControl, value]);
 }

package/{field/root → internals/field-root-context}/FieldRootContext.d.ts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import type { FieldValidityData, FieldRootState } from "./FieldRoot.js";
+import type { FieldValidityData, FieldRootState } from "../../field/root/FieldRoot.js";
 import type { Form } from "../../form/index.js";
-import type { UseFieldValidationReturnValue } from "./useFieldValidation.js";
-import type { FieldControlRegistration } from "./useFieldControlRegistration.js";
+import type { UseFieldValidationReturnValue } from "../../field/root/useFieldValidation.js";
+import type { FieldControlRegistration } from "../field-register-control/useFieldControlRegistration.js";
 export interface FieldRootContext {
   invalid: boolean | undefined;
   name: string | undefined;
@@ -26,5 +26,6 @@ export interface FieldRootContext {
   registerFieldControl: (source: symbol, registration: FieldControlRegistration | undefined) => void;
   validation: UseFieldValidationReturnValue;
 }
+export declare const DEFAULT_FIELD_ROOT_CONTEXT: FieldRootContext;
 export declare const FieldRootContext: React.Context<FieldRootContext>;
 export declare function useFieldRootContext(optional?: boolean): FieldRootContext;

package/{field/root → internals/field-root-context}/FieldRootContext.js

@@ -6,14 +6,14 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.FieldRootContext = void 0;
+exports.FieldRootContext = exports.DEFAULT_FIELD_ROOT_CONTEXT = void 0;
 exports.useFieldRootContext = useFieldRootContext;
 var _formatErrorMessage2 = _interopRequireDefault(require("@base-ui/utils/formatErrorMessage"));
 var React = _interopRequireWildcard(require("react"));
-var _noop = require("../../utils/noop");
-var _constants = require("../utils/constants");
-var _constants2 = require("../../utils/constants");
-const FieldRootContext = exports.FieldRootContext = /*#__PURE__*/React.createContext({
+var _empty = require("@base-ui/utils/empty");
+var _noop = require("../noop");
+var _constants = require("../field-constants/constants");
+const DEFAULT_FIELD_ROOT_CONTEXT = exports.DEFAULT_FIELD_ROOT_CONTEXT = {
   invalid: undefined,
   name: undefined,
   validityData: {
@@ -43,14 +43,15 @@ const FieldRootContext = exports.FieldRootContext = /*#__PURE__*/React.createCon
   },
   registerFieldControl: _noop.NOOP,
   validation: {
-    getValidationProps: (props = _constants2.EMPTY_OBJECT) => props,
-    getInputValidationProps: (props = _constants2.EMPTY_OBJECT) => props,
+    getValidationProps: (props = _empty.EMPTY_OBJECT) => props,
+    getInputValidationProps: (props = _empty.EMPTY_OBJECT) => props,
     inputRef: {
       current: null
     },
     commit: async () => {}
   }
-});
+};
+const FieldRootContext = exports.FieldRootContext = /*#__PURE__*/React.createContext(DEFAULT_FIELD_ROOT_CONTEXT);
 if (process.env.NODE_ENV !== "production") FieldRootContext.displayName = "FieldRootContext";
 function useFieldRootContext(optional = true) {
   const context = React.useContext(FieldRootContext);

package/internals/field-root-context/index.d.ts

@@ -0,0 +1,2 @@
+export { FieldRootContext, useFieldRootContext } from "./FieldRootContext.js";
+export type { FieldRootContext as FieldRootContextType } from "./FieldRootContext.js";

package/internals/field-root-context/index.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "FieldRootContext", {
+  enumerable: true,
+  get: function () {
+    return _FieldRootContext.FieldRootContext;
+  }
+});
+Object.defineProperty(exports, "useFieldRootContext", {
+  enumerable: true,
+  get: function () {
+    return _FieldRootContext.useFieldRootContext;
+  }
+});
+var _FieldRootContext = require("./FieldRootContext");

package/internals/filter.d.ts

@@ -0,0 +1,16 @@
+export declare function getFilter(options?: GetFilterParameters): Filter;
+export interface GetFilterParameters extends Intl.CollatorOptions {
+  /**
+   * The locale to use for string comparison.
+   * Defaults to the user's runtime locale.
+   */
+  locale?: Intl.LocalesArgument | undefined;
+}
+export interface Filter {
+  /** Returns whether the item matches the query anywhere. */
+  contains: <Item>(item: Item, query: string, itemToString?: (item: Item) => string) => boolean;
+  /** Returns whether the item starts with the query. */
+  startsWith: <Item>(item: Item, query: string, itemToString?: (item: Item) => string) => boolean;
+  /** Returns whether the item ends with the query. */
+  endsWith: <Item>(item: Item, query: string, itemToString?: (item: Item) => string) => boolean;
+}

package/internals/filter.js

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getFilter = getFilter;
+var _resolveValueLabel = require("./resolveValueLabel");
+const filterCache = new Map();
+function getFilter(options = {}) {
+  const mergedOptions = {
+    usage: 'search',
+    sensitivity: 'base',
+    ignorePunctuation: true,
+    ...options
+  };
+  const cacheKey = `${stringifyLocale(options.locale)}|${JSON.stringify(mergedOptions)}`;
+  const cachedFilter = filterCache.get(cacheKey);
+  if (cachedFilter) {
+    return cachedFilter;
+  }
+  const collator = new Intl.Collator(options.locale, mergedOptions);
+  const filter = {
+    contains(item, query, itemToString) {
+      if (!query) {
+        return true;
+      }
+      const itemString = (0, _resolveValueLabel.stringifyAsLabel)(item, itemToString);
+      for (let i = 0; i <= itemString.length - query.length; i += 1) {
+        if (collator.compare(itemString.slice(i, i + query.length), query) === 0) {
+          return true;
+        }
+      }
+      return false;
+    },
+    startsWith(item, query, itemToString) {
+      if (!query) {
+        return true;
+      }
+      const itemString = (0, _resolveValueLabel.stringifyAsLabel)(item, itemToString);
+      return collator.compare(itemString.slice(0, query.length), query) === 0;
+    },
+    endsWith(item, query, itemToString) {
+      if (!query) {
+        return true;
+      }
+      const itemString = (0, _resolveValueLabel.stringifyAsLabel)(item, itemToString);
+      const queryLength = query.length;
+      return itemString.length >= queryLength && collator.compare(itemString.slice(itemString.length - queryLength), query) === 0;
+    }
+  };
+  filterCache.set(cacheKey, filter);
+  return filter;
+}
+function stringifyLocale(locale) {
+  if (Array.isArray(locale)) {
+    return locale.map(value => stringifyLocale(value)).join(',');
+  }
+  if (locale == null) {
+    return '';
+  }
+  return String(locale);
+}

package/{esm/form → internals/form-context}/FormContext.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import type { FieldValidityData } from "../field/root/FieldRoot.js";
-import type { Form } from "./Form.js";
+import type { FieldValidityData } from "../../field/root/FieldRoot.js";
+import type { Form } from "../../form/Form.js";
 export type Errors = Record<string, string | string[]>;
 export interface FormContext {
   errors: Errors;
@@ -8,7 +8,11 @@ export interface FormContext {
   formRef: React.RefObject<{
     fields: Map<string, {
       name: string | undefined;
-      validate: (flushSync?: boolean | undefined) => void;
+      /**
+       * After this returns, the field registry entry reflects the latest synchronous
+       * validity verdict. Async validators do not block submit.
+       */
+      validate: () => void;
       validityData: FieldValidityData;
       controlRef: React.RefObject<HTMLElement | null>;
       getValue: () => unknown;

package/{form → internals/form-context}/FormContext.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.FormContext = void 0;
 exports.useFormContext = useFormContext;
 var React = _interopRequireWildcard(require("react"));
-var _noop = require("../utils/noop");
+var _noop = require("../noop");
 const FormContext = exports.FormContext = /*#__PURE__*/React.createContext({
   formRef: {
     current: {

package/internals/form-context/index.d.ts

@@ -0,0 +1,2 @@
+export { FormContext, useFormContext } from "./FormContext.js";
+export type { Errors } from "./FormContext.js";

package/internals/form-context/index.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "FormContext", {
+  enumerable: true,
+  get: function () {
+    return _FormContext.FormContext;
+  }
+});
+Object.defineProperty(exports, "useFormContext", {
+  enumerable: true,
+  get: function () {
+    return _FormContext.useFormContext;
+  }
+});
+var _FormContext = require("./FormContext");

package/{labelable-provider → internals/labelable-provider}/LabelableContext.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { HTMLProps } from "../utils/types.js";
+import { HTMLProps } from "../types.js";
 export interface LabelableContext {
   /**
    * The `id` of the labelable element.

package/{labelable-provider → internals/labelable-provider}/LabelableContext.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.LabelableContext = void 0;
 exports.useLabelableContext = useLabelableContext;
 var React = _interopRequireWildcard(require("react"));
-var _noop = require("../utils/noop");
+var _noop = require("../noop");
 /**
  * A context for providing [labelable elements](https://html.spec.whatwg.org/multipage/forms.html#category-label)\
  * with an accessible name (label) and description.

package/{labelable-provider → internals/labelable-provider}/LabelableProvider.js

@@ -9,8 +9,8 @@ exports.LabelableProvider = void 0;
 var React = _interopRequireWildcard(require("react"));
 var _useStableCallback = require("@base-ui/utils/useStableCallback");
 var _useRefWithInit = require("@base-ui/utils/useRefWithInit");
-var _mergeProps = require("../merge-props");
-var _useBaseUiId = require("../utils/useBaseUiId");
+var _mergeProps = require("../../merge-props");
+var _useBaseUiId = require("../useBaseUiId");
 var _LabelableContext = require("./LabelableContext");
 var _jsxRuntime = require("react/jsx-runtime");
 /**

package/internals/labelable-provider/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./LabelableProvider.js";
+export { useAriaLabelledBy } from "./useAriaLabelledBy.js";
+export { useLabelableContext } from "./LabelableContext.js";
+export { useLabelableId } from "./useLabelableId.js";
+export { useLabel } from "./useLabel.js";
+export type { UseLabelParameters, UseLabelReturnValue } from "./useLabel.js";