@wordpress/ui 0.12.1-next.v.202604201441.0 → 0.13.0

package/build-types/form/primitives/autocomplete/stories/fixtures.d.ts

@@ -0,0 +1,8 @@
+export interface FixtureItem {
+    id: string;
+    value: string;
+}
+export declare const COMMANDS: FixtureItem[];
+export declare const USERS: FixtureItem[];
+export declare const URLS: FixtureItem[];
+//# sourceMappingURL=fixtures.d.ts.map

package/build-types/form/primitives/autocomplete/stories/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/autocomplete/stories/fixtures.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,QAAQ,EAAE,WAAW,EASjC,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,WAAW,EAQ9B,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,WAAW,EAQ7B,CAAC"}

package/build-types/form/primitives/autocomplete/stories/index.story.d.ts

@@ -0,0 +1,41 @@
+import type { Meta, StoryObj } from '@storybook/react-vite';
+import * as Autocomplete from '../index';
+declare const meta: Meta<typeof Autocomplete.Root>;
+export default meta;
+type Story = StoryObj<typeof Autocomplete.Root>;
+/**
+ * The input accepts free-form text while suggesting matching items.
+ */
+export declare const Default: Story;
+/**
+ * Controls the popup so it only opens when there is at least one match.
+ */
+export declare const OpenOnlyOnMatch: Story;
+export declare const AsyncItems: Story;
+/**
+ * The suggestion list can be rendered inline by enabling `inline` and `open`.
+ */
+export declare const Inline: Story;
+export declare const WithSearchIconAndClearButton: Story;
+/**
+ * Experimental: Textarea with inline autocomplete triggered by `@`.
+ */
+export declare const TextareaInlineAutocomplete: Story;
+/**
+ * Popovers in Gutenberg are managed with explicit z-index values, which can
+ * create situations where an autocomplete popup renders below another popover
+ * when you want it above.
+ *
+ * The `--wp-ui-autocomplete-z-index` CSS variable controls the z-index of the
+ * `Autocomplete` positioner. Override it either:
+ *
+ * - **Globally**, by setting the variable on `:root` or `body` (raises every
+ *   `Autocomplete` popup in the page), or
+ * - **Per instance**, by passing an `Autocomplete.Portal` with a `style` (or
+ *   `className`) to `Autocomplete.Popup`'s `portal` prop. The variable cascades
+ *   from the portal wrapper to everything rendered inside it.
+ *
+ * This story demonstrates the per-instance approach.
+ */
+export declare const WithCustomZIndex: Story;
+//# sourceMappingURL=index.story.d.ts.map

package/build-types/form/primitives/autocomplete/stories/index.story.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/autocomplete/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,YAAY,MAAM,UAAU,CAAC;AAOzC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,YAAY,CAAC,IAAI,CAuBzC,CAAC;eACa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,YAAY,CAAC,IAAI,CAAE,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,OAAO,EAAE,KA0BrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,KA4C7B,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,KAiDxB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,KAyCpB,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,KA6C1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,0BAA0B,EAAE,KAiIxC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAgC9B,CAAC"}

package/build-types/form/primitives/autocomplete/test/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/build-types/form/primitives/autocomplete/test/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/autocomplete/test/index.test.tsx"],"names":[],"mappings":""}

package/build-types/form/primitives/autocomplete/types.d.ts

@@ -0,0 +1,44 @@
+import type { Autocomplete as _Autocomplete } from '@base-ui/react/autocomplete';
+import type { ComponentPropsWithoutRef, ReactElement } from 'react';
+import type { ComponentProps } from '../../../utils/types';
+export type AutocompleteCollectionProps = _Autocomplete.Collection.Props;
+export type PortalProps = ComponentPropsWithoutRef<typeof _Autocomplete.Portal>;
+export type AutocompleteClearProps = ComponentProps<typeof _Autocomplete.Clear> & {
+    children?: React.ReactNode;
+};
+export type AutocompleteEmptyProps = ComponentProps<typeof _Autocomplete.Empty> & {
+    children?: React.ReactNode;
+};
+export type AutocompleteInputProps = Omit<ComponentProps<typeof _Autocomplete.Input>, 'size'>;
+export type AutocompleteInputGroupProps = ComponentProps<typeof _Autocomplete.InputGroup> & {
+    children?: React.ReactNode;
+};
+export type AutocompleteItemProps = ComponentProps<typeof _Autocomplete.Item> & {
+    children?: React.ReactNode;
+};
+export type AutocompleteListProps = ComponentProps<typeof _Autocomplete.List> & {
+    children?: _Autocomplete.List.Props['children'];
+};
+export type AutocompleteListBodyProps = ComponentProps<'div'> & {
+    children?: React.ReactNode;
+};
+export type AutocompletePopupProps = ComponentProps<typeof _Autocomplete.Popup> & {
+    children?: React.ReactNode;
+    /**
+     * Optional portal element, typically `<Autocomplete.Portal />` with custom
+     * `container`. When omitted, `Autocomplete.Popup` uses
+     * `Autocomplete.Portal` with default props. Do not pass `children` on the
+     * portal element; they would be ignored.
+     */
+    portal?: ReactElement<Omit<PortalProps, 'children'>>;
+};
+export type AutocompleteRootProps = ComponentProps<typeof _Autocomplete.Root> & {
+    children?: React.ReactNode;
+};
+export type AutocompleteValueProps = {
+    /**
+     * Can be used to override the current value of the autocomplete.
+     */
+    children?: _Autocomplete.Value.Props['children'];
+};
+//# sourceMappingURL=types.d.ts.map

package/build-types/form/primitives/autocomplete/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/autocomplete/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;AAEzE,MAAM,MAAM,WAAW,GAAG,wBAAwB,CACjD,OAAO,aAAa,CAAC,MAAM,CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAClD,OAAO,aAAa,CAAC,KAAK,CAC1B,GAAG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAClD,OAAO,aAAa,CAAC,KAAK,CAC1B,GAAG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACxC,cAAc,CAAE,OAAO,aAAa,CAAC,KAAK,CAAE,EAC5C,MAAM,CACN,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,cAAc,CACvD,OAAO,aAAa,CAAC,UAAU,CAC/B,GAAG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,cAAc,CACjD,OAAO,aAAa,CAAC,IAAI,CACzB,GAAG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,cAAc,CACjD,OAAO,aAAa,CAAC,IAAI,CACzB,GAAG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,KAAK,CAAE,UAAU,CAAE,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,cAAc,CAAE,KAAK,CAAE,GAAG;IACjE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAClD,OAAO,aAAa,CAAC,KAAK,CAC1B,GAAG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,CAAE,IAAI,CAAE,WAAW,EAAE,UAAU,CAAE,CAAE,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,cAAc,CACjD,OAAO,aAAa,CAAC,IAAI,CACzB,GAAG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACpC;;OAEG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,KAAK,CAAE,UAAU,CAAE,CAAC;CACnD,CAAC"}

package/build-types/form/primitives/autocomplete/value.d.ts

@@ -0,0 +1,3 @@
+import type { AutocompleteValueProps } from './types';
+export declare function Value(props: AutocompleteValueProps): import("react").JSX.Element;
+//# sourceMappingURL=value.d.ts.map

package/build-types/form/primitives/autocomplete/value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/autocomplete/value.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,wBAAgB,KAAK,CAAE,KAAK,EAAE,sBAAsB,+BAEnD"}

package/build-types/form/primitives/field/control.d.ts

@@ -1,6 +1,6 @@
 import { Field as _Field } from '@base-ui/react/field';
 export declare const Control: import("react").ForwardRefExoticComponent<Omit<import("../../../utils/types").ComponentProps<import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").FieldControlProps, "ref"> & import("react").RefAttributes<HTMLElement>>>, "defaultValue"> & {
-    children?: _Field.Control.Props["children"];
-    defaultValue?: _Field.Control.Props["defaultValue"];
+    children?: _Field.Control.Props['children'];
+    defaultValue?: _Field.Control.Props['defaultValue'];
 } & import("react").RefAttributes<HTMLInputElement>>;
 //# sourceMappingURL=control.d.ts.map

package/build-types/form/primitives/field/description.d.ts

@@ -1,4 +1,4 @@
-export declare const Description: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").FieldDescriptionProps, "ref"> & import("react").RefAttributes<HTMLParagraphElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const Description: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").FieldDescriptionProps, "ref"> & import("react").RefAttributes<HTMLParagraphElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {

package/build-types/form/primitives/field/details.d.ts

@@ -10,7 +10,7 @@
  * If the content only includes plain text, use `Field.Description` instead,
  * so the readout is not unnecessarily verbose for screen reader users.
  */
-export declare const Details: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const Details: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {

package/build-types/form/primitives/field/label.d.ts

@@ -1,13 +1,13 @@
 import { Field as _Field } from '@base-ui/react/field';
-export declare const Label: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").FieldLabelProps, "ref"> & import("react").RefAttributes<HTMLElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const Label: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").FieldLabelProps, "ref"> & import("react").RefAttributes<HTMLElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {
         ref?: import("react").Ref<any> | undefined;
     }) => React.ReactElement<unknown>) | React.ReactElement<Record<string, unknown>>;
 } & {
-    children?: _Field.Label.Props["children"];
+    children?: _Field.Label.Props['children'];
     hideFromVision?: boolean;
-    variant?: "default" | "plain";
+    variant?: 'default' | 'plain';
 } & import("react").RefAttributes<HTMLLabelElement>>;
 //# sourceMappingURL=label.d.ts.map

package/build-types/form/primitives/field/root.d.ts

@@ -8,8 +8,8 @@ import { Field as _Field } from '@base-ui/react/field';
  * Simply wrapping a control with this component does not guarantee
  * accessible labeling. See examples for how to associate the label in different cases.
  */
-export declare const Root: import("react").ForwardRefExoticComponent<Omit<import("../../../utils/types").ComponentProps<import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").FieldRootProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>>, "disabled" | "validate" | "validationMode" | "validationDebounceTime" | "invalid" | "dirty" | "touched"> & {
-    children?: _Field.Root.Props["children"];
-    disabled?: _Field.Root.Props["disabled"];
+export declare const Root: import("react").ForwardRefExoticComponent<Omit<import("../../../utils/types").ComponentProps<import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").FieldRootProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>>, "dirty" | "disabled" | "invalid" | "touched" | "validate" | "validationDebounceTime" | "validationMode"> & {
+    children?: _Field.Root.Props['children'];
+    disabled?: _Field.Root.Props['disabled'];
 } & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=root.d.ts.map

package/build-types/form/primitives/field/stories/index.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/field/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,KAAK,MAAM,KAAK,CAAC;AAG7B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,KAAK,CAAC,IAAI,CAUlC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAchD,CAAC;AAQF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAoBrD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAoB5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAWpD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAYpD,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/field/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,KAAK,MAAM,KAAK,CAAC;AAG7B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,KAAK,CAAC,IAAI,CAiBlC,CAAC;eACa,IAAI;AAEnB;;;;GAIG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAchD,CAAC;AAQF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAoBrD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAoB5D,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAWpD,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAE,OAAO,KAAK,CAAC,IAAI,CAYpD,CAAC"}

package/build-types/form/primitives/fieldset/description.d.ts

@@ -1,4 +1,4 @@
-export declare const FieldsetDescription: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const FieldsetDescription: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {

package/build-types/form/primitives/fieldset/details.d.ts

@@ -10,7 +10,7 @@
  * If the content only includes plain text, use `Fieldset.Description` instead,
  * so the readout is not unnecessarily verbose for screen reader users.
  */
-export declare const FieldsetDetails: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const FieldsetDetails: import("react").ForwardRefExoticComponent<Omit<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {

package/build-types/form/primitives/fieldset/legend.d.ts

@@ -1,4 +1,4 @@
-export declare const FieldsetLegend: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").FieldsetLegendProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const FieldsetLegend: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").FieldsetLegendProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {

package/build-types/form/primitives/fieldset/root.d.ts

@@ -4,7 +4,7 @@
  *
  * To label a single form control element, use the `Field` component instead.
  */
-export declare const FieldsetRoot: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").FieldsetRootProps, "ref"> & import("react").RefAttributes<HTMLElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const FieldsetRoot: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").FieldsetRootProps, "ref"> & import("react").RefAttributes<HTMLElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {

package/build-types/form/primitives/fieldset/stories/index.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/fieldset/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,QAAQ,MAAM,KAAK,CAAC;AAGhC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,QAAQ,CAAC,IAAI,CAQrC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,QAAQ,CAAC,IAAI,CAAE,CAAC;AAE9C,eAAO,MAAM,OAAO,EAAE,KAiBrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,KAc1B,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,KAezB,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/fieldset/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,QAAQ,MAAM,KAAK,CAAC;AAGhC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,QAAQ,CAAC,IAAI,CAerC,CAAC;eACa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,QAAQ,CAAC,IAAI,CAAE,CAAC;AAE9C,eAAO,MAAM,OAAO,EAAE,KAiBrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,KAc1B,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,EAAE,KAezB,CAAC"}

package/build-types/form/primitives/index.d.ts

@@ -1,3 +1,4 @@
+export * as Autocomplete from './autocomplete';
 export * as Field from './field';
 export * as Fieldset from './fieldset';
 export { Input } from './input';

package/build-types/form/primitives/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/form/primitives/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/form/primitives/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/build-types/form/primitives/input/input.d.ts

@@ -1,10 +1,10 @@
 import { Input as _Input } from '@base-ui/react/input';
-export declare const Input: import("react").ForwardRefExoticComponent<Omit<import("../../../utils/types").ComponentProps<import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").InputProps, "ref"> & import("react").RefAttributes<HTMLElement>>>, "defaultValue" | "prefix" | "disabled" | "type" | "value" | "size"> & Pick<import("../input-layout/types").InputLayoutProps, "prefix" | "suffix"> & {
+export declare const Input: import("react").ForwardRefExoticComponent<Omit<import("../../../utils/types").ComponentProps<import("react").ForwardRefExoticComponent<Omit<import("@base-ui/react").InputProps, "ref"> & import("react").RefAttributes<HTMLElement>>>, "defaultValue" | "disabled" | "prefix" | "size" | "type" | "value"> & Pick<import("../input-layout/types").InputLayoutProps, "prefix" | "suffix"> & {
     disabled?: boolean;
 } & {
-    type?: _Input.Props["type"];
-    defaultValue?: _Input.Props["defaultValue"];
-    value?: _Input.Props["value"];
-    size?: Exclude<import("../input-layout/types").InputLayoutProps["size"], "small">;
+    type?: _Input.Props['type'];
+    defaultValue?: _Input.Props['defaultValue'];
+    value?: _Input.Props['value'];
+    size?: Exclude<import("../input-layout/types").InputLayoutProps['size'], 'small'>;
 } & import("react").RefAttributes<HTMLElement>>;
 //# sourceMappingURL=input.d.ts.map

package/build-types/form/primitives/input/stories/index.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/input/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,KAAK,CAS7B,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,KAAK,CAAE,CAAC;AAEtC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,KAKxB,CAAC;AAMF,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,eAAO,MAAM,QAAQ,EAAE,KAKtB,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/input/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,KAAK,CAgB7B,CAAC;eACa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,KAAK,CAAE,CAAC;AAEtC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,KAKxB,CAAC;AAMF,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,eAAO,MAAM,QAAQ,EAAE,KAKtB,CAAC"}

package/build-types/form/primitives/input-layout/stories/index.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/input-layout/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAGlC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,WAAW,CAMnC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,WAAW,CAAE,CAAC;AAE5C,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,KAiBxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAI9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAc/B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,KAInB,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/input-layout/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC;AAGlC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,WAAW,CAanC,CAAC;eACa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,WAAW,CAAE,CAAC;AAE5C,eAAO,MAAM,OAAO,EAAE,KAErB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,KAiBxB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAI9B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAc/B,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,KAAK,EAAE,KAInB,CAAC"}

package/build-types/form/primitives/select/index.d.ts

@@ -1,4 +1,5 @@
 export { Item } from './item';
+export { Portal } from './portal';
 export { Popup } from './popup';
 export { Root } from './root';
 export { Trigger } from './trigger';

package/build-types/form/primitives/select/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}

package/build-types/form/primitives/select/item.d.ts

@@ -1,7 +1,7 @@
 import { Select as _Select } from '@base-ui/react/select';
 export declare const Item: import("react").ForwardRefExoticComponent<Omit<import("../../../utils/types").ComponentProps<import("react").NamedExoticComponent<Omit<import("@base-ui/react").SelectItemProps, "ref"> & import("react").RefAttributes<HTMLElement>>>, "value"> & {
-    value?: string;
-    size?: import("../input-layout/types").InputLayoutProps["size"];
-    children?: _Select.Item.Props["children"];
+    value?: unknown;
+    size?: import("../input-layout/types").InputLayoutProps['size'];
+    children?: _Select.Item.Props['children'];
 } & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=item.d.ts.map

package/build-types/form/primitives/select/item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/item.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAS1D,eAAO,MAAM,IAAI;;;;kDA6BhB,CAAC"}
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/item.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAS1D,eAAO,MAAM,IAAI;;;;kDA4BhB,CAAC"}

package/build-types/form/primitives/select/popup.d.ts

@@ -1,5 +1,4 @@
-import { Select as _Select } from '@base-ui/react/select';
-export declare const Popup: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").SelectPopupProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const Popup: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").SelectPopupProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {
@@ -7,6 +6,6 @@ export declare const Popup: import("react").ForwardRefExoticComponent<Omit<Omit<
     }) => React.ReactElement<unknown>) | React.ReactElement<Record<string, unknown>>;
 } & {
     children?: React.ReactNode;
-    container?: _Select.Portal.Props["container"];
+    portal?: import("react").ReactElement<Omit<import("./types").PortalProps, 'children'>>;
 } & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=popup.d.ts.map

package/build-types/form/primitives/select/popup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/popup.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAiB1D,eAAO,MAAM,KAAK;;;;;;;;;kDAwCjB,CAAC"}
+{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/popup.tsx"],"names":[],"mappings":"AAmBA,eAAO,MAAM,KAAK;;;;;;;;;kDAmCjB,CAAC"}

package/build-types/form/primitives/select/portal.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Root element that portals `Select` listbox content. Pass to
+ * `Select.Popup`'s `portal` prop. When `portal` is omitted, `Select.Popup`
+ * uses this component with default props.
+ */
+declare const Portal: import("react").ForwardRefExoticComponent<Omit<Omit<import("@base-ui/react").SelectPortalProps, "ref"> & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export { Portal };
+//# sourceMappingURL=portal.d.ts.map

package/build-types/form/primitives/select/portal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/portal.tsx"],"names":[],"mappings":"AAIA;;;;GAIG;AACH,QAAA,MAAM,MAAM,iNAIX,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/build-types/form/primitives/select/root.d.ts

@@ -1,3 +1,14 @@
 import type { SelectRootProps } from './types';
-export declare function Root(props: SelectRootProps): import("react").JSX.Element;
+/**
+ * A component that lets users choose one option from a list.
+ *
+ * When using object values, pass an `items` array so `Select.Trigger` can
+ * auto-resolve the selected item's label. By default, items should use a
+ * `{ value, label }` shape, or provide `itemToStringLabel` for a custom shape.
+ *
+ * Object values are compared with `Object.is` by default, so use the same
+ * object references for `value` / `defaultValue` and `Select.Item` values, or
+ * provide `isItemEqualToValue`.
+ */
+export declare function Root<Value = unknown>(props: SelectRootProps<Value>): import("react").JSX.Element;
 //# sourceMappingURL=root.d.ts.map

package/build-types/form/primitives/select/root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/root.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,wBAAgB,IAAI,CAAE,KAAK,EAAE,eAAe,+BAE3C"}
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/root.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAE,KAAK,GAAG,OAAO,EAAI,KAAK,EAAE,eAAe,CAAE,KAAK,CAAE,+BAEvE"}

package/build-types/form/primitives/select/stories/index.story.d.ts

@@ -15,13 +15,16 @@ export declare const Compact: Story;
  */
 export declare const Minimal: Story;
 /**
- * By passing an `items` array to `Select.Root`, the `Select.Trigger` will be able to
- * render a `label` string for each item rather than the raw `value` string. In this
- * case, the option with an empty string value has a `"Select"` label string.
- *
- * This may be easier than writing a custom render function for the `Select.Trigger`.
+ * Use the `placeholder` prop on `Select.Trigger` to show text when no
+ * value is selected. The default placeholder is `"Select"`.
+ */
+export declare const WithCustomPlaceholder: Story;
+/**
+ * Use a `null` item when users should be able to clear the selected value from
+ * the popup. When `items` includes a `null` item, its label is used as the
+ * placeholder text.
  */
-export declare const WithEmptyValueOption: Story;
+export declare const WithNullValueOption: Story;
 /**
  * When accessibly labeling a `Select`, note that the label must be associated with the `Select.Trigger`,
  * not the `Select.Root`.
@@ -38,12 +41,20 @@ export declare const WithDisabledItem: Story;
  */
 export declare const WithCustomTriggerAndItem: Story;
 /**
- * Popovers in Gutenberg are managed with explicit z-index values, which can create
- * situations where a popover renders below another popover, when you want it to be rendered above.
+ * Popovers in Gutenberg are managed with explicit z-index values, which can
+ * create situations where a select popup renders below another popover when
+ * you want it above.
+ *
+ * The `--wp-ui-select-z-index` CSS variable controls the z-index of the
+ * `Select` positioner. Override it either:
+ *
+ * - **Globally**, by setting the variable on `:root` or `body` (raises every
+ *   `Select` popover in the page), or
+ * - **Per instance**, by passing a `Select.Portal` with a `style` (or
+ *   `className`) to `Select.Popup`'s `portal` prop. The variable cascades
+ *   from the portal wrapper to everything rendered inside it.
  *
- * The `--wp-ui-select-z-index` CSS variable, available on the `Select.Popup` component,
- * is an escape hatch that can be used to override the z-index of a given `Select` popover
- * on a case-by-case basis.
+ * This story demonstrates the per-instance approach.
  */
 export declare const WithCustomZIndex: Story;
 //# sourceMappingURL=index.story.d.ts.map

package/build-types/form/primitives/select/stories/index.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/select/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,KAAK,CAAC;AAE9B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,MAAM,CAAC,IAAI,CAQnC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,MAAM,CAAC,IAAI,CAAE,CAAC;AAE5C,eAAO,MAAM,OAAO,EAAE,KAgBrB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAkBrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,KAkBrB,CAAC;AAcF;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAsBlC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,KAatB,CAAC;AAKF,eAAO,MAAM,YAAY,EAAE,KAa1B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KActB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,KAa9B,CAAC;AAaF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAwCtC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAc9B,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/select/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,MAAM,MAAM,KAAK,CAAC;AAE9B,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,MAAM,CAAC,IAAI,CAgBnC,CAAC;eACa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,MAAM,CAAC,IAAI,CAAE,CAAC;AAO5C,eAAO,MAAM,OAAO,EAAE,KAgBrB,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,KAoBrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,EAAE,KAoBrB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAgBnC,CAAC;AASF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,KAmBjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,EAAE,KAgBtB,CAAC;AAgBF,eAAO,MAAM,YAAY,EAAE,KAiB1B,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAkBtB,CAAC;AAcF,eAAO,MAAM,gBAAgB,EAAE,KAqB9B,CAAC;AAaF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAqCtC,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAuB9B,CAAC"}

package/build-types/form/primitives/select/trigger.d.ts

@@ -1,13 +1,14 @@
 import { Select as _Select } from '@base-ui/react/select';
-export declare const Trigger: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").SelectTriggerProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>, "ref">, "style" | "className" | "children" | "render"> & {
+export declare const Trigger: import("react").ForwardRefExoticComponent<Omit<Omit<Omit<import("@base-ui/react").SelectTriggerProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>, "ref">, "children" | "className" | "render" | "style"> & {
     className?: string;
     style?: React.CSSProperties;
     render?: ((props: import("react").HTMLAttributes<any> & {
         ref?: import("react").Ref<any> | undefined;
     }) => React.ReactElement<unknown>) | React.ReactElement<Record<string, unknown>>;
 } & {
-    size?: import("../input-layout/types").InputLayoutProps["size"];
-    variant?: "default" | "minimal";
-    children?: _Select.Value.Props["children"];
+    size?: import("../input-layout/types").InputLayoutProps['size'];
+    variant?: 'default' | 'minimal';
+    placeholder?: _Select.Value.Props['placeholder'];
+    children?: _Select.Value.Props['children'];
 } & import("react").RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=trigger.d.ts.map

package/build-types/form/primitives/select/trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/trigger.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAU1D,eAAO,MAAM,OAAO;;;;;;;;;;qDA+CnB,CAAC"}
+{"version":3,"file":"trigger.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/trigger.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAW1D,eAAO,MAAM,OAAO;;;;;;;;;;;qDAiDnB,CAAC"}

package/build-types/form/primitives/select/types.d.ts

@@ -1,7 +1,9 @@
 import type { Select as _Select } from '@base-ui/react/select';
+import type { ComponentPropsWithoutRef, ReactElement } from 'react';
 import type { ComponentProps } from '../../../utils/types';
 import type { InputLayoutProps } from '../input-layout/types';
-export type SelectRootProps = Omit<_Select.Root.Props<string, false>, 'multiple'>;
+export type PortalProps = ComponentPropsWithoutRef<typeof _Select.Portal>;
+export type SelectRootProps<Value = unknown> = Omit<_Select.Root.Props<Value, false>, 'multiple'>;
 export type SelectTriggerProps = ComponentProps<typeof _Select.Trigger> & {
     /**
      * The size of the trigger.
@@ -15,9 +17,19 @@ export type SelectTriggerProps = ComponentProps<typeof _Select.Trigger> & {
      * @default 'default'
      */
     variant?: 'default' | 'minimal';
+    /**
+     * Text to show when no value is selected.
+     * This is overridden by `children` if specified, or by a null item's label in `items`.
+     *
+     * @default __( 'Select' )
+     */
+    placeholder?: _Select.Value.Props['placeholder'];
     /**
      * A function that gets called with the current value as an argument.
      * Use this to customize the trigger content.
+     *
+     * When no value is selected, the rendered content inherits the
+     * placeholder text color.
      */
     children?: _Select.Value.Props['children'];
 };
@@ -27,15 +39,18 @@ export type SelectPopupProps = ComponentProps<typeof _Select.Popup> & {
      */
     children?: React.ReactNode;
     /**
-     * A parent element to render the portal into.
+     * Optional portal element, typically `<Select.Portal />` with custom
+     * `container`. When omitted, `Select.Popup` uses `Select.Portal` with
+     * default props. Do not pass `children` on the portal element; they would
+     * be ignored.
      */
-    container?: _Select.Portal.Props['container'];
+    portal?: ReactElement<Omit<PortalProps, 'children'>>;
 };
 export type SelectItemProps = Omit<ComponentProps<typeof _Select.Item>, 'value'> & {
     /**
      * A unique value that identifies this select item.
      */
-    value?: string;
+    value?: unknown;
     /**
      * The size of the item.
      *
@@ -44,8 +59,6 @@ export type SelectItemProps = Omit<ComponentProps<typeof _Select.Item>, 'value'>
     size?: InputLayoutProps['size'];
     /**
      * The content of the item.
-     *
-     * @default `value`
      */
     children?: _Select.Item.Props['children'];
 };

package/build-types/form/primitives/select/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,MAAM,MAAM,eAAe,GAAG,IAAI,CACjC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,MAAM,EAAE,KAAK,CAAE,EACnC,UAAU,CACV,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAE,OAAO,OAAO,CAAC,OAAO,CAAE,GAAG;IAC3E;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAE,MAAM,CAAE,CAAC;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAE,UAAU,CAAE,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAE,OAAO,OAAO,CAAC,KAAK,CAAE,GAAG;IACvE;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAE,WAAW,CAAE,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CACjC,cAAc,CAAE,OAAO,OAAO,CAAC,IAAI,CAAE,EACrC,OAAO,CACP,GAAG;IACH;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAE,MAAM,CAAE,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,UAAU,CAAE,CAAC;CAC5C,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/form/primitives/select/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,wBAAwB,CAAE,OAAO,OAAO,CAAC,MAAM,CAAE,CAAC;AAG5E,MAAM,MAAM,eAAe,CAAE,KAAK,GAAG,OAAO,IAAK,IAAI,CACpD,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,KAAK,EAAE,KAAK,CAAE,EAClC,UAAU,CACV,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAE,OAAO,OAAO,CAAC,OAAO,CAAE,GAAG;IAC3E;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAE,MAAM,CAAE,CAAC;IAClC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAChC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAE,aAAa,CAAE,CAAC;IACnD;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAE,UAAU,CAAE,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAE,OAAO,OAAO,CAAC,KAAK,CAAE,GAAG;IACvE;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,YAAY,CAAE,IAAI,CAAE,WAAW,EAAE,UAAU,CAAE,CAAE,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CACjC,cAAc,CAAE,OAAO,OAAO,CAAC,IAAI,CAAE,EACrC,OAAO,CACP,GAAG;IACH;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAE,MAAM,CAAE,CAAC;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAE,UAAU,CAAE,CAAC;CAC5C,CAAC"}

package/build-types/form/primitives/textarea/stories/index.story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/textarea/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,QAAQ,CAGhC,CAAC;AACF,eAAe,IAAI,CAAC;AAEpB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,QAAQ,CAAE,CAAC;AAEzC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAKtB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAK1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,KAKxB,CAAC"}
+{"version":3,"file":"index.story.d.ts","sourceRoot":"","sources":["../../../../../src/form/primitives/textarea/stories/index.story.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAE,OAAO,QAAQ,CAUhC,CAAC;eACa,IAAI;AAEnB,KAAK,KAAK,GAAG,QAAQ,CAAE,OAAO,QAAQ,CAAE,CAAC;AAEzC,eAAO,MAAM,OAAO,EAAE,KAIrB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,KAKtB,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,KAK1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,KAKxB,CAAC"}

package/build-types/form/primitives/textarea/textarea.d.ts

@@ -1,4 +1,4 @@
-export declare const Textarea: import("react").ForwardRefExoticComponent<Omit<import("../../../utils/types").ComponentProps<"textarea">, "defaultValue" | "disabled" | "value" | "rows"> & Pick<import("../input/types").InputProps, "defaultValue" | "disabled" | "value" | "onValueChange"> & {
-    rows?: React.ComponentProps<"textarea">["rows"];
+export declare const Textarea: import("react").ForwardRefExoticComponent<Omit<import("../../../utils/types").ComponentProps<"textarea">, "defaultValue" | "disabled" | "rows" | "value"> & Pick<import("../input/types").InputProps, "defaultValue" | "disabled" | "onValueChange" | "value"> & {
+    rows?: React.ComponentProps<'textarea'>['rows'];
 } & import("react").RefAttributes<HTMLTextAreaElement>>;
 //# sourceMappingURL=textarea.d.ts.map

package/build-types/form/select-control/context.d.ts

@@ -0,0 +1,3 @@
+export declare const SelectControlSizeContext: import("react").Context<"compact" | "default" | "small" | undefined>;
+export declare const useSelectControlSizeContext: () => "compact" | "default" | "small" | undefined;
+//# sourceMappingURL=context.d.ts.map

package/build-types/form/select-control/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/form/select-control/context.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,sEACsB,CAAC;AAE5D,eAAO,MAAM,2BAA2B,mDAEvC,CAAC"}

package/build-types/form/select-control/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A complete select field with integrated label and description.
+ */
+export declare const SelectControl: import("react").ForwardRefExoticComponent<Omit<import("../primitives/select/types").SelectRootProps<import("./types").SelectItem>, "inputRef" | "items"> & import("../types").ControlProps & {
+    className?: string;
+    items?: import("./types").SelectItem[];
+    placeholder?: import("../primitives/select/types").SelectTriggerProps['placeholder'];
+    triggerContent?: ((item: import("./types").SelectItem) => React.ReactNode) | React.ReactNode;
+    size?: Exclude<import("../primitives/select/types").SelectTriggerProps['size'], 'small'>;
+} & import("react").RefAttributes<HTMLButtonElement>> & {
+    /**
+     * An item rendered inside a `SelectControl` popup.
+     */
+    Item: import("react").ForwardRefExoticComponent<Omit<import("../../utils/types").ComponentProps<import("react").NamedExoticComponent<Omit<import("@base-ui/react").SelectItemProps, "ref"> & import("react").RefAttributes<HTMLElement>>>, "value"> & {
+        value?: unknown;
+        size?: import("../primitives/input-layout/types").InputLayoutProps['size'];
+        children?: import("@base-ui/react").SelectItem.Props['children'];
+    } & import("react").RefAttributes<HTMLDivElement>>;
+};
+//# sourceMappingURL=index.d.ts.map

package/build-types/form/select-control/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/form/select-control/index.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;IACzB;;OAEG;;;;;;CAED,CAAC"}