@base-ui/react 1.3.0 → 1.4.1

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/{esm → 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";

package/internals/labelable-provider/index.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  useAriaLabelledBy: true,
+  useLabelableContext: true,
+  useLabelableId: true,
+  useLabel: true
+};
+Object.defineProperty(exports, "useAriaLabelledBy", {
+  enumerable: true,
+  get: function () {
+    return _useAriaLabelledBy.useAriaLabelledBy;
+  }
+});
+Object.defineProperty(exports, "useLabel", {
+  enumerable: true,
+  get: function () {
+    return _useLabel.useLabel;
+  }
+});
+Object.defineProperty(exports, "useLabelableContext", {
+  enumerable: true,
+  get: function () {
+    return _LabelableContext.useLabelableContext;
+  }
+});
+Object.defineProperty(exports, "useLabelableId", {
+  enumerable: true,
+  get: function () {
+    return _useLabelableId.useLabelableId;
+  }
+});
+var _LabelableProvider = require("./LabelableProvider");
+Object.keys(_LabelableProvider).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _LabelableProvider[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _LabelableProvider[key];
+    }
+  });
+});
+var _useAriaLabelledBy = require("./useAriaLabelledBy");
+var _LabelableContext = require("./LabelableContext");
+var _useLabelableId = require("./useLabelableId");
+var _useLabel = require("./useLabel");

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

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.useAriaLabelledBy = useAriaLabelledBy;
 var React = _interopRequireWildcard(require("react"));
 var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
-var _useBaseUiId = require("../utils/useBaseUiId");
+var _useBaseUiId = require("../useBaseUiId");
 /**
  * @internal
  */

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

@@ -9,8 +9,8 @@ exports.useLabel = useLabel;
 var _dom = require("@floating-ui/utils/dom");
 var _owner = require("@base-ui/utils/owner");
 var _useStableCallback = require("@base-ui/utils/useStableCallback");
-var _utils = require("../floating-ui-react/utils");
-var _useRegisteredLabelId = require("../utils/useRegisteredLabelId");
+var _utils = require("../../floating-ui-react/utils");
+var _useRegisteredLabelId = require("../../utils/useRegisteredLabelId");
 var _LabelableContext = require("./LabelableContext");
 function useLabel(params = {}) {
   const {
@@ -74,7 +74,6 @@ function focusElementWithVisible(element) {
   element.focus({
     // Available from Chrome 144+ (January 2026).
     // Safari and Firefox already support it.
-    // @ts-expect-error not available in types yet
     focusVisible: true
   });
 }

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

@@ -11,8 +11,8 @@ var _useIsoLayoutEffect = require("@base-ui/utils/useIsoLayoutEffect");
 var _useStableCallback = require("@base-ui/utils/useStableCallback");
 var _useRefWithInit = require("@base-ui/utils/useRefWithInit");
 var _dom = require("@floating-ui/utils/dom");
-var _noop = require("../utils/noop");
-var _useBaseUiId = require("../utils/useBaseUiId");
+var _noop = require("../noop");
+var _useBaseUiId = require("../useBaseUiId");
 var _LabelableContext = require("./LabelableContext");
 function useLabelableId(params = {}) {
   const {

package/internals/shadowDom.d.ts

@@ -0,0 +1,3 @@
+export declare function activeElement(doc: Document): Element | null;
+export declare function contains(parent?: Element | null, child?: Element | null): boolean;
+export declare function getTarget(event: Event): EventTarget | null;

package/internals/shadowDom.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.activeElement = activeElement;
+exports.contains = contains;
+exports.getTarget = getTarget;
+var _dom = require("@floating-ui/utils/dom");
+function activeElement(doc) {
+  let element = doc.activeElement;
+  while (element?.shadowRoot?.activeElement != null) {
+    element = element.shadowRoot.activeElement;
+  }
+  return element;
+}
+function contains(parent, child) {
+  if (!parent || !child) {
+    return false;
+  }
+  const rootNode = child.getRootNode?.();
+
+  // First, attempt with the faster native method.
+  if (parent.contains(child)) {
+    return true;
+  }
+
+  // Then fall back to traversing out of shadow roots when needed.
+  if (rootNode && (0, _dom.isShadowRoot)(rootNode)) {
+    let next = child;
+    while (next) {
+      if (parent === next) {
+        return true;
+      }
+      next = next.parentNode || next.host;
+    }
+  }
+  return false;
+}
+function getTarget(event) {
+  if ('composedPath' in event) {
+    return event.composedPath()[0];
+  }
+
+  // TS assumes `composedPath()` always exists, but older browsers without
+  // shadow DOM support still fall back to `target`.
+  return event.target;
+}

package/internals/temporal/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./temporal-adapter.js";
+export * from "./temporal.js";

package/internals/temporal/index.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _temporalAdapter = require("./temporal-adapter");
+Object.keys(_temporalAdapter).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _temporalAdapter[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _temporalAdapter[key];
+    }
+  });
+});
+var _temporal = require("./temporal");
+Object.keys(_temporal).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _temporal[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _temporal[key];
+    }
+  });
+});

package/internals/temporal/temporal-adapter.d.ts

@@ -0,0 +1,371 @@
+import { TemporalTimezone, TemporalSupportedObject, TemporalSupportedValue } from "./temporal.js";
+export interface TemporalAdapterFormats {
+  /**
+   * The 4-digit year.
+   * @example "2019"
+   */
+  yearPadded: string;
+  /**
+   * The month with leading zeros.
+   * @example "08"
+   */
+  monthPadded: string;
+  /**
+   * The day of the month with leading zeros.
+   * @example "01"
+   */
+  dayOfMonthPadded: string;
+  /**
+   * The hours with leading zeros, 24-hour clock.
+   * @example "01", "23"
+   */
+  hours24hPadded: string;
+  /**
+   * The hours with leading zeros, 12-hour clock.
+   * @example "01", "11"
+   */
+  hours12hPadded: string;
+  /**
+   * The minutes with leading zeros.
+   * @example "01", "59"
+   */
+  minutesPadded: string;
+  /**
+   * The seconds with leading zeros.
+   * @example "01", "59"
+   */
+  secondsPadded: string;
+  /**
+   * The day of the month without leading zeros.
+   * @example "1"
+   */
+  dayOfMonth: string;
+  /**
+   * The hours without leading zeros, 24-hour clock.
+   * @example "1", "23"
+   */
+  hours24h: string;
+  /**
+   * The hours without leading zeros, 12-hour clock.
+   * @example "1", "11"
+   */
+  hours12h: string;
+  /**
+   * The abbreviated month name.
+   * @example "Aug"
+   */
+  month3Letters: string;
+  /**
+   * The full month name.
+   * @example "August"
+   */
+  monthFullLetter: string;
+  /**
+   * The week day name.
+   * @example "Wednesday"
+   */
+  weekday: string;
+  /**
+   * The abbreviated week day name.
+   * @example "Wed"
+   * */
+  weekday3Letters: string;
+  /**
+   * The initial of the week day name.
+   * @example "W"
+   * */
+  weekday1Letter: string;
+  /**
+   * The meridiem.
+   * @example "AM"
+   */
+  meridiem: string;
+  /**
+   * The localized date format including year, month, day and weekday.
+   * @example "Wednesday, August 6, 2014"
+   */
+  localizedDateWithFullMonthAndWeekDay: string;
+  /**
+   * The localized numeric date format including year, month and day.
+   * @example "8/6/2014"
+   */
+  localizedNumericDate: string;
+}
+export type DateBuilderReturnType<T extends string | null> = [T] extends [null] ? null : TemporalSupportedObject;
+export interface TemporalAdapter {
+  isTimezoneCompatible: boolean;
+  formats: TemporalAdapterFormats;
+  /**
+   * Name of the library that is used right now.
+   */
+  lib: string;
+  /**
+   * Characters used to escape a string inside a format.
+   */
+  escapedCharacters: {
+    start: string;
+    end: string;
+  };
+  /**
+   * Creates a date in the date library format.
+   */
+  date<T extends string | null>(value: T, timezone: TemporalTimezone): DateBuilderReturnType<T>;
+  /**
+   * Parses a date from a string in the given format.
+   */
+  parse(value: string, format: string, timezone: TemporalTimezone): TemporalSupportedObject;
+  /**
+   * Creates a date in the date library format for the current time.
+   */
+  now(timezone: TemporalTimezone): TemporalSupportedObject;
+  /**
+   * Extracts the timezone from a date.
+   */
+  getTimezone(value: TemporalSupportedValue | null): TemporalTimezone;
+  /**
+   * Converts a date to another timezone.
+   */
+  setTimezone(value: TemporalSupportedObject, timezone: TemporalTimezone): TemporalSupportedObject;
+  /**
+   * Converts a date in the library format into a JavaScript `Date` object.
+   */
+  toJsDate(value: TemporalSupportedObject): Date;
+  /**
+   * Gets the code of the locale currently used by the adapter.
+   */
+  getCurrentLocaleCode(): string;
+  /**
+   * Checks if the date is valid.
+   */
+  isValid(value: TemporalSupportedValue): value is TemporalSupportedObject;
+  /**
+   * Formats a date using an adapter format string (see the `AdapterFormats` interface).
+   */
+  format(value: TemporalSupportedObject, formatKey: keyof TemporalAdapterFormats): string;
+  /**
+   * Formats a date using a format of the date library.
+   */
+  formatByString(value: TemporalSupportedObject, formatString: string): string;
+  /**
+   * Checks if the two dates are equal (which means they represent the same timestamp).
+   */
+  isEqual(value: TemporalSupportedValue, comparing: TemporalSupportedValue): boolean;
+  /**
+   * Checks if the two dates are in the same year.
+   * Uses the timezone of the `value`.
+   */
+  isSameYear(value: TemporalSupportedObject, comparing: TemporalSupportedObject): boolean;
+  /**
+   * Checks if the two dates are in the same month.
+   * Uses the timezone of the `value`.
+   */
+  isSameMonth(value: TemporalSupportedObject, comparing: TemporalSupportedObject): boolean;
+  /**
+   * Checks if the two dates are in the same day.
+   * Uses the timezone of the `value`.
+   */
+  isSameDay(value: TemporalSupportedObject, comparing: TemporalSupportedObject): boolean;
+  /**
+   * Checks if the two dates are at the same hour.
+   * Uses the timezone of the `value`.
+   */
+  isSameHour(value: TemporalSupportedObject, comparing: TemporalSupportedObject): boolean;
+  /**
+   * Checks if the `value` date is after the `comparing` date.
+   */
+  isAfter(value: TemporalSupportedObject, comparing: TemporalSupportedObject): boolean;
+  /**
+   * Checks if the `value` date is before the `comparing` date.
+   */
+  isBefore(value: TemporalSupportedObject, comparing: TemporalSupportedObject): boolean;
+  /**
+   * Checks if the value is within the provided range.
+   */
+  isWithinRange(value: TemporalSupportedObject, range: [TemporalSupportedObject, TemporalSupportedObject]): boolean;
+  /**
+   * Returns the start of the year for the given date.
+   */
+  startOfYear(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the start of the month for the given date.
+   */
+  startOfMonth(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the start of the week for the given date.
+   */
+  startOfWeek(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the start of the day for the given date.
+   */
+  startOfDay(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the start of the hour for the given date.
+   */
+  startOfHour(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the start of the minute for the given date.
+   */
+  startOfMinute(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the start of the second for the given date.
+   */
+  startOfSecond(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the end of the year for the given date.
+   */
+  endOfYear(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the end of the month for the given date.
+   */
+  endOfMonth(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the end of the week for the given date.
+   */
+  endOfWeek(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the end of the day for the given date.
+   */
+  endOfDay(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the end of the hour for the given date.
+   */
+  endOfHour(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the end of the minute for the given date.
+   */
+  endOfMinute(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Returns the end of the second for the given date.
+   */
+  endOfSecond(value: TemporalSupportedObject): TemporalSupportedObject;
+  /**
+   * Adds the specified number of years to the given date.
+   */
+  addYears(value: TemporalSupportedObject, amount: number): TemporalSupportedObject;
+  /**
+   * Adds the specified number of months to the given date.
+   */
+  addMonths(value: TemporalSupportedObject, amount: number): TemporalSupportedObject;
+  /**
+   * Adds the specified number of weeks to the given date.
+   */
+  addWeeks(value: TemporalSupportedObject, amount: number): TemporalSupportedObject;
+  /**
+   * Adds the specified number of days to the given date.
+   */
+  addDays(value: TemporalSupportedObject, amount: number): TemporalSupportedObject;
+  /**
+   * Adds the specified number of hours to the given date.
+   */
+  addHours(value: TemporalSupportedObject, amount: number): TemporalSupportedObject;
+  /**
+   * Adds the specified number of minutes to the given date.
+   */
+  addMinutes(value: TemporalSupportedObject, amount: number): TemporalSupportedObject;
+  /**
+   * Adds the specified number of seconds to the given date.
+   */
+  addSeconds(value: TemporalSupportedObject, amount: number): TemporalSupportedObject;
+  /**
+   * Adds the specified number of milliseconds to the given date.
+   */
+  addMilliseconds(value: TemporalSupportedObject, amount: number): TemporalSupportedObject;
+  /**
+   * Gets the year of the given date.
+   */
+  getYear(value: TemporalSupportedObject): number;
+  /**
+   * Gets the month of the given date.
+   * The value is 0-based, in the Gregorian calendar January = 0, February = 1, ...
+   */
+  getMonth(value: TemporalSupportedObject): number;
+  /**
+   * Gets the date (day in the month) of the given date.
+   */
+  getDate(value: TemporalSupportedObject): number;
+  /**
+   * Gets the hours of the given date.
+   */
+  getHours(value: TemporalSupportedObject): number;
+  /**
+   * Gets the minutes of the given date.
+   */
+  getMinutes(value: TemporalSupportedObject): number;
+  /**
+   * Gets the seconds of the given date.
+   */
+  getSeconds(value: TemporalSupportedObject): number;
+  /**
+   * Gets the milliseconds of the given date.
+   */
+  getMilliseconds(value: TemporalSupportedObject): number;
+  /**
+   * Gets the time since epoch of the given date.
+   */
+  getTime(value: TemporalSupportedObject): number;
+  /**
+   * Sets the year to the given date.
+   */
+  setYear(value: TemporalSupportedObject, year: number): TemporalSupportedObject;
+  /**
+   * Sets the month to the given date.
+   */
+  setMonth(value: TemporalSupportedObject, month: number): TemporalSupportedObject;
+  /**
+   * Sets the date (day in the month) to the given date.
+   */
+  setDate(value: TemporalSupportedObject, date: number): TemporalSupportedObject;
+  /**
+   * Sets the hours to the given date.
+   */
+  setHours(value: TemporalSupportedObject, hours: number): TemporalSupportedObject;
+  /**
+   * Sets the minutes to the given date.
+   */
+  setMinutes(value: TemporalSupportedObject, minutes: number): TemporalSupportedObject;
+  /**
+   * Sets the seconds to the given date.
+   */
+  setSeconds(value: TemporalSupportedObject, seconds: number): TemporalSupportedObject;
+  /**
+   * Sets the milliseconds to the given date.
+   */
+  setMilliseconds(value: TemporalSupportedObject, milliseconds: number): TemporalSupportedObject;
+  /**
+   * Gets the number of full years between the given dates.
+   */
+  differenceInYears: (value: TemporalSupportedObject, comparing: TemporalSupportedObject) => number;
+  /**
+   * Gets the number of full months between the given dates.
+   */
+  differenceInMonths: (value: TemporalSupportedObject, comparing: TemporalSupportedObject) => number;
+  /**
+   * Gets the number of full weeks between the given dates.
+   */
+  differenceInWeeks: (value: TemporalSupportedObject, comparing: TemporalSupportedObject) => number;
+  /**
+   * Gets the number of full days between the given dates.
+   */
+  differenceInDays: (value: TemporalSupportedObject, comparing: TemporalSupportedObject) => number;
+  /**
+   * Gets the number of full hours between the given dates.
+   */
+  differenceInHours: (value: TemporalSupportedObject, comparing: TemporalSupportedObject) => number;
+  /**
+   * Gets the number of full minutes between the given dates.
+   */
+  differenceInMinutes: (value: TemporalSupportedObject, comparing: TemporalSupportedObject) => number;
+  /**
+   * Gets the number of days in a month of the given date.
+   */
+  getDaysInMonth(value: TemporalSupportedObject): number;
+  /**
+   * Gets the number of the week of the given date.
+   */
+  getWeekNumber(value: TemporalSupportedObject): number;
+  /**
+   * Gets the number of the day of the week of the given date.
+   * The value is 1-based, 1 - first day of the week, 7 - last day of the week.
+   */
+  getDayOfWeek(value: TemporalSupportedObject): number;
+}

package/internals/temporal/temporal.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Lookup in which each date library can register its supported date object type.
+ *
+ * ```
+ * // Example taken from the TemporalAdapterDateFns.ts file.
+ * declare module '@base-ui/react/internals/temporal' {
+ *   interface TemporalSupportedObjectLookup {
+ *     'date-fns': Date;
+ *   }
+ * }
+ * ```
+ */
+export interface TemporalSupportedObjectLookup {}
+/**
+ * The valid shape date objects can take in the components and utilities that deal with dates and times.
+ */
+export type TemporalSupportedObject = keyof TemporalSupportedObjectLookup extends never ? any : TemporalSupportedObjectLookup[keyof TemporalSupportedObjectLookup];
+/**
+ * The valid value for the timezone argument in components and utilities that deal with dates and times.
+ */
+export type TemporalTimezone = 'default' | 'system' | 'UTC' | string;
+/**
+ * The type that the `value` and `defaultValue` props can receive on non-range date and time components (date, time and date-time).
+ */
+export type TemporalValue = TemporalSupportedObject | null;
+/**
+ * The type that the `value` and `defaultValue` props can receive on range components (date-range, time-range and date-time-range).
+ */
+export type TemporalRangeValue = [TemporalValue, TemporalValue];
+/**
+ * The type that the `value` and `defaultValue` props can receive on all temporal components.
+ */
+export type TemporalSupportedValue = TemporalValue | TemporalRangeValue;
+export type TemporalNonNullableRangeValue = [TemporalSupportedObject, TemporalSupportedObject];
+export type TemporalNonNullableValue<TValue extends TemporalSupportedValue> = TValue extends TemporalRangeValue ? TValue extends TemporalValue ? TemporalSupportedObject | TemporalNonNullableRangeValue : TemporalNonNullableRangeValue : TemporalSupportedObject;

package/internals/temporal/temporal.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});