@funstack/ui 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/form/form-submit.d.mts

@@ -0,0 +1,31 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/form/form-submit.d.ts
+export interface FormSubmitState {
+  /** The enclosing form's submission is in flight (`useFormStatus().pending`). */
+  readonly pending: boolean;
+  readonly disabled: boolean;
+}
+export interface FormSubmitProps extends Omit<ComponentPropsWithRef<"button">, "type" | "className" | "style" | "children"> {
+  /** Native `disabled`; owned. Never set by the library (conventions 3.6). */
+  disabled?: boolean;
+  className?: StateValue<string | undefined, FormSubmitState>;
+  style?: StateValue<CSSProperties | undefined, FormSubmitState>;
+  children?: StateValue<ReactNode, FormSubmitState>;
+  render?: RenderProp<ComponentPropsWithRef<"button">, FormSubmitState>;
+}
+/**
+ * The form's submit button: `<button type="submit">` with `data-pending` while the enclosing
+ * form's submission is in flight (`useFormStatus`). Works in any React-rendered form
+ * (`Form.Root`, `Dialog.Form`, a plain `<form action>`). Never disabled while pending: block
+ * repeat clicks with CSS on `[data-pending]` if you need to.
+ *
+ * Owned keys (conventions 1.2): `type` (on a `<button>`), `disabled`, `data-pending`,
+ * `data-disabled`.
+ */
+export declare function FormSubmit({ disabled, className, style, children, render, ...rest }: FormSubmitProps): ReactNode;
+export declare namespace FormSubmit {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=form-submit.d.mts.map

package/dist/form/form-submit.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-submit.d.mts","names":[],"sources":["../../src/form/form-submit.tsx"],"mappings":";;;iBAUiB;;WAEN;WACA;;iBAGM,wBAAwB,KACvC;;EAIA;EACA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;EAC9C,WAAW,WAAW,WAAW;EACjC,SAAS,WAAW,iCAAiC;;;;;;;;;;;wBAYvC,aACd,UACA,WACA,OACA,UACA,WACG,QACF,kBAAe;yBAPF"}

package/dist/form/form-submit.mjs

@@ -0,0 +1,52 @@
+"use client";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { rendersButton, useRender } from "../internal/use-render.mjs";
+import { useCallback, useRef } from "react";
+import { useFormStatus } from "react-dom";
+//#region src/form/form-submit.tsx
+const isDev = process.env.NODE_ENV !== "production";
+/**
+* The form's submit button: `<button type="submit">` with `data-pending` while the enclosing
+* form's submission is in flight (`useFormStatus`). Works in any React-rendered form
+* (`Form.Root`, `Dialog.Form`, a plain `<form action>`). Never disabled while pending: block
+* repeat clicks with CSS on `[data-pending]` if you need to.
+*
+* Owned keys (conventions 1.2): `type` (on a `<button>`), `disabled`, `data-pending`,
+* `data-disabled`.
+*/
+function FormSubmit({ disabled = false, className, style, children, render, ...rest }) {
+	const { pending } = useFormStatus();
+	const warned = useRef(false);
+	const ref = useCallback((el) => {
+		const submitter = el.tagName === "BUTTON" || el.tagName === "INPUT" && ["submit", "image"].includes(el.type);
+		if (isDev && !warned.current && !submitter) {
+			warned.current = true;
+			console.error(`Form.Submit: expected to render a <button> (or <input type="submit">) but got <${el.tagName.toLowerCase()}>. Only a submit button submits the form natively.`);
+		}
+		return () => {};
+	}, []);
+	return useRender({
+		defaultElement: "button",
+		render,
+		state: {
+			pending,
+			disabled
+		},
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: {
+			...rendersButton(render) && { type: "submit" },
+			disabled,
+			"data-pending": dataAttr(pending),
+			"data-disabled": dataAttr(disabled)
+		},
+		ref
+	});
+}
+FormSubmit.displayName = "FormSubmit";
+//#endregion
+export { FormSubmit };
+
+//# sourceMappingURL=form-submit.mjs.map

package/dist/form/form-submit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-submit.mjs","names":[],"sources":["../../src/form/form-submit.tsx"],"sourcesContent":["\"use client\";\nimport { useCallback, useRef } from \"react\";\nimport type { ComponentPropsWithRef, CSSProperties, ReactNode } from \"react\";\nimport { useFormStatus } from \"react-dom\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { rendersButton, useRender } from \"../internal/use-render.js\";\n\nconst isDev = process.env.NODE_ENV !== \"production\";\n\nexport interface FormSubmitState {\n  /** The enclosing form's submission is in flight (`useFormStatus().pending`). */\n  readonly pending: boolean;\n  readonly disabled: boolean;\n}\n\nexport interface FormSubmitProps extends Omit<\n  ComponentPropsWithRef<\"button\">,\n  \"type\" | \"className\" | \"style\" | \"children\"\n> {\n  /** Native `disabled`; owned. Never set by the library (conventions 3.6). */\n  disabled?: boolean;\n  className?: StateValue<string | undefined, FormSubmitState>;\n  style?: StateValue<CSSProperties | undefined, FormSubmitState>;\n  children?: StateValue<ReactNode, FormSubmitState>;\n  render?: RenderProp<ComponentPropsWithRef<\"button\">, FormSubmitState>;\n}\n\n/**\n * The form's submit button: `<button type=\"submit\">` with `data-pending` while the enclosing\n * form's submission is in flight (`useFormStatus`). Works in any React-rendered form\n * (`Form.Root`, `Dialog.Form`, a plain `<form action>`). Never disabled while pending: block\n * repeat clicks with CSS on `[data-pending]` if you need to.\n *\n * Owned keys (conventions 1.2): `type` (on a `<button>`), `disabled`, `data-pending`,\n * `data-disabled`.\n */\nexport function FormSubmit({\n  disabled = false,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: FormSubmitProps) {\n  const { pending } = useFormStatus();\n  const warned = useRef(false);\n  const ref = useCallback((el: HTMLElement) => {\n    const submitter =\n      el.tagName === \"BUTTON\" ||\n      (el.tagName === \"INPUT\" && [\"submit\", \"image\"].includes((el as HTMLInputElement).type));\n    if (isDev && !warned.current && !submitter) {\n      warned.current = true;\n      console.error(\n        `Form.Submit: expected to render a <button> (or <input type=\"submit\">) but got ` +\n          `<${el.tagName.toLowerCase()}>. Only a submit button submits the form natively.`,\n      );\n    }\n    // A cleanup, so the merged ref never calls this with `null`.\n    return () => {};\n  }, []);\n  const state: FormSubmitState = { pending, disabled };\n  return useRender<ComponentPropsWithRef<\"button\">, FormSubmitState>({\n    defaultElement: \"button\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps: {\n      ...(rendersButton(render) && { type: \"submit\" as const }),\n      disabled,\n      \"data-pending\": dataAttr(pending),\n      \"data-disabled\": dataAttr(disabled),\n    },\n    ref,\n  });\n}\n\nFormSubmit.displayName = \"FormSubmit\";\n"],"mappings":";;;;;;AAQA,MAAM,QAAQ,QAAQ,IAAI,aAAa;;;;;;;;;;AA6BvC,SAAgB,WAAW,EACzB,WAAW,OACX,WACA,OACA,UACA,QACA,GAAG,QACe;CAClB,MAAM,EAAE,YAAY,cAAc;CAClC,MAAM,SAAS,OAAO,KAAK;CAC3B,MAAM,MAAM,aAAa,OAAoB;EAC3C,MAAM,YACJ,GAAG,YAAY,YACd,GAAG,YAAY,WAAW,CAAC,UAAU,OAAO,CAAC,CAAC,SAAU,GAAwB,IAAI;EACvF,IAAI,SAAS,CAAC,OAAO,WAAW,CAAC,WAAW;GAC1C,OAAO,UAAU;GACjB,QAAQ,MACN,kFACM,GAAG,QAAQ,YAAY,EAAE,mDACjC;EACF;EAEA,aAAa,CAAC;CAChB,GAAG,CAAC,CAAC;CAEL,OAAO,UAA4D;EACjE,gBAAgB;EAChB;EACA,OAAA;GAJ+B;GAAS;EAIpC;EACJ;EACA;EACA;EACA,OAAO;EACP,cAAc;GACZ,GAAI,cAAc,MAAM,KAAK,EAAE,MAAM,SAAkB;GACvD;GACA,gBAAgB,SAAS,OAAO;GAChC,iBAAiB,SAAS,QAAQ;EACpC;EACA;CACF,CAAC;AACH;AAEA,WAAW,cAAc"}

package/dist/form/index.d.mts

@@ -0,0 +1,11 @@
+import { FieldErrorValue, FormErrors } from "../internal/validity.mjs";
+import { FormRoot, FormRootProps, FormRootState } from "./form-root.mjs";
+import { FormSubmit, FormSubmitProps, FormSubmitState } from "./form-submit.mjs";
+//#region src/form/index.d.ts
+export declare const Form: {
+  readonly Root: typeof FormRoot;
+  readonly Submit: typeof FormSubmit;
+};
+//#endregion
+export type { FieldErrorValue, FormErrors, FormRootProps, FormRootState, FormSubmitProps, FormSubmitState };
+//# sourceMappingURL=index.d.mts.map

package/dist/form/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/form/index.ts"],"mappings":";;;;qBAGa;WAAS,aAAI;WAAY,eAAM"}

package/dist/form/index.mjs

@@ -0,0 +1,11 @@
+import { FormRoot } from "./form-root.mjs";
+import { FormSubmit } from "./form-submit.mjs";
+//#region src/form/index.ts
+const Form = {
+	Root: FormRoot,
+	Submit: FormSubmit
+};
+//#endregion
+export { Form };
+
+//# sourceMappingURL=index.mjs.map

package/dist/form/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/form/index.ts"],"sourcesContent":["import { FormRoot } from \"./form-root.js\";\nimport { FormSubmit } from \"./form-submit.js\";\n\nexport const Form = { Root: FormRoot, Submit: FormSubmit } as const;\n\nexport type { FormRootProps, FormRootState, FormErrors, FieldErrorValue } from \"./form-root.js\";\nexport type { FormSubmitProps, FormSubmitState } from \"./form-submit.js\";\n"],"mappings":";;;AAGA,MAAa,OAAO;CAAE,MAAM;CAAU,QAAQ;AAAW"}

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import "./internal/platform-attributes.mjs";
-import { Action, ActionDetails, ChangeAction, ChangeReason, RenderProp, StateValue } from "./internal/types.mjs";
+import { Action, ActionDetails, ChangeAction, ChangeReason, RenderProp, StateValue, UrgentChangeAction } from "./internal/types.mjs";
 import { AccordionItemProps, AccordionItemState } from "./accordion/accordion-item.mjs";
 import { AccordionPanelProps, AccordionPanelState } from "./accordion/accordion-panel.mjs";
 import { AccordionRootExclusiveProps, AccordionRootMultipleProps, AccordionRootProps, AccordionRootState, AccordionValueChangeDetails } from "./accordion/accordion-root.mjs";
@@ -12,6 +12,16 @@ import { CheckboxGroupParentProps, CheckboxGroupParentState } from "./checkbox-g
 import { CheckboxGroup } from "./checkbox-group/index.mjs";
 import { Checkbox, CheckboxCheckedChangeDetails, CheckboxProps, CheckboxState } from "./checkbox/checkbox.mjs";
 import "./checkbox/index.mjs";
+import { ComboboxClearProps, ComboboxClearState } from "./combobox/combobox-clear.mjs";
+import { ComboboxListProps, ComboboxListState } from "./combobox/combobox-list.mjs";
+import { ComboboxEmptyProps, ComboboxEmptyState, ComboboxGroupLabelProps, ComboboxGroupLabelState, ComboboxGroupProps, ComboboxGroupState, ComboboxStatusProps, ComboboxStatusState } from "./combobox/combobox-group.mjs";
+import { ComboboxInputProps, ComboboxInputState } from "./combobox/combobox-input.mjs";
+import { ComboboxLabelProps, ComboboxLabelState } from "./combobox/combobox-label.mjs";
+import { ComboboxOptionProps, ComboboxOptionState } from "./combobox/combobox-option.mjs";
+import { ComboboxPopupProps, ComboboxPopupState } from "./combobox/combobox-popup.mjs";
+import { ComboboxInputValueChangeDetails, ComboboxOpenChangeDetails, ComboboxRootProps, ComboboxRootState, ComboboxValueChangeDetails } from "./combobox/combobox-root.mjs";
+import { ComboboxTriggerProps, ComboboxTriggerState } from "./combobox/combobox-trigger.mjs";
+import { Combobox } from "./combobox/index.mjs";
 import { DialogCloseDetails, DialogCloseProps, DialogCloseState } from "./dialog/dialog-close.mjs";
 import { DialogPopupProps, DialogPopupState } from "./dialog/dialog-popup.mjs";
 import { DialogDescriptionProps, DialogDescriptionState } from "./dialog/dialog-description.mjs";
@@ -20,6 +30,17 @@ import { DialogOpenChangeDetails, DialogRootProps, DialogRootState } from "./dia
 import { DialogTitleProps, DialogTitleState } from "./dialog/dialog-title.mjs";
 import { DialogTriggerProps, DialogTriggerState } from "./dialog/dialog-trigger.mjs";
 import { Dialog } from "./dialog/index.mjs";
+import { FieldErrorValue, FieldValidity, FormErrors } from "./internal/validity.mjs";
+import { FieldState } from "./internal/field-context.mjs";
+import { FieldControlProps } from "./field/field-control.mjs";
+import { FieldDescriptionProps } from "./field/field-description.mjs";
+import { FieldErrorProps } from "./field/field-error.mjs";
+import { FieldLabelProps } from "./field/field-label.mjs";
+import { FieldRootProps, FieldValidate } from "./field/field-root.mjs";
+import { Field } from "./field/index.mjs";
+import { FormRootProps, FormRootState } from "./form/form-root.mjs";
+import { FormSubmitProps, FormSubmitState } from "./form/form-submit.mjs";
+import { Form } from "./form/index.mjs";
 import { Toggle, TogglePressedChangeDetails, ToggleProps, ToggleState } from "./toggle/toggle.mjs";
 import "./toggle/index.mjs";
 import { TabsActivationMode, TabsOrientation } from "./tabs/tabs-context.mjs";
@@ -57,4 +78,27 @@ import { RadioGroupItemProps, RadioGroupItemState } from "./radio-group/radio-gr
 import { RadioGroupRootProps, RadioGroupRootState, RadioGroupValueChangeDetails } from "./radio-group/radio-group-root.mjs";
 import { RadioGroupLabelProps } from "./radio-group/radio-group-label.mjs";
 import { RadioGroup } from "./radio-group/index.mjs";
-export { Accordion, type AccordionItemProps, type AccordionItemState, type AccordionPanelProps, type AccordionPanelState, type AccordionRootExclusiveProps, type AccordionRootMultipleProps, type AccordionRootProps, type AccordionRootState, type AccordionTriggerProps, type AccordionTriggerState, type AccordionValueChangeDetails, type Action, type ActionDetails, type ChangeAction, type ChangeReason, Checkbox, type CheckboxCheckedChangeDetails, CheckboxGroup, type CheckboxGroupItemProps, type CheckboxGroupItemState, type CheckboxGroupLabelProps, type CheckboxGroupParentProps, type CheckboxGroupParentState, type CheckboxGroupRootProps, type CheckboxGroupRootState, type CheckboxGroupValueChangeDetails, type CheckboxProps, type CheckboxState, Dialog, type DialogCloseDetails, type DialogCloseProps, type DialogCloseState, type DialogDescriptionProps, type DialogDescriptionState, type DialogFormProps, type DialogFormState, type DialogOpenChangeDetails, type DialogPopupProps, type DialogPopupState, type DialogRootProps, type DialogRootState, type DialogTitleProps, type DialogTitleState, type DialogTriggerProps, type DialogTriggerState, Menu, type MenuAlign, type MenuCheckboxItemProps, type MenuCheckboxItemState, type MenuGroupLabelProps, type MenuGroupLabelState, type MenuGroupProps, type MenuGroupState, type MenuItemDetails, type MenuItemProps, type MenuItemState, type MenuOpenChangeDetails, type MenuPopupProps, type MenuPopupState, type MenuRadioGroupProps, type MenuRadioGroupState, type MenuRadioItemProps, type MenuRadioItemState, type MenuRootProps, type MenuRootState, type MenuSeparatorProps, type MenuSeparatorState, type MenuSide, type MenuSubmenuTriggerProps, type MenuSubmenuTriggerState, type MenuTriggerProps, type MenuTriggerState, Popover, type PopoverAlign, type PopoverCloseProps, type PopoverCloseState, type PopoverDescriptionProps, type PopoverDescriptionState, type PopoverOpenChangeDetails, type PopoverPopupProps, type PopoverPopupState, type PopoverRootProps, type PopoverRootState, type PopoverSide, type PopoverTitleProps, type PopoverTitleState, type PopoverTriggerProps, type PopoverTriggerState, RadioGroup, type RadioGroupItemProps, type RadioGroupItemState, type RadioGroupLabelProps, type RadioGroupRootProps, type RadioGroupRootState, type RadioGroupValueChangeDetails, type RenderProp, type StateValue, Switch, type SwitchCheckedChangeDetails, type SwitchProps, type SwitchState, Tabs, type TabsActivationMode, type TabsIndicatorProps, type TabsIndicatorState, type TabsListProps, type TabsListState, type TabsOrientation, type TabsPanelProps, type TabsPanelState, type TabsRootProps, type TabsRootState, type TabsTabProps, type TabsTabState, type TabsValueChangeDetails, Toggle, type TogglePressedChangeDetails, type ToggleProps, type ToggleState, Tooltip, type TooltipAlign, type TooltipPopupProps, type TooltipPopupState, type TooltipProvides, type TooltipRootProps, type TooltipRootState, type TooltipSide, type TooltipTriggerProps, type TooltipTriggerState };
+import { SelectRootProps, SelectRootState, SelectValueChangeDetails } from "./select/select-root.mjs";
+import { SelectGroupProps } from "./select/select-group.mjs";
+import { SelectGroupLabelProps } from "./select/select-group-label.mjs";
+import { SelectOptionProps, SelectOptionState } from "./select/select-option.mjs";
+import { SelectSeparatorProps } from "./select/select-separator.mjs";
+import { SelectTriggerProps } from "./select/select-trigger.mjs";
+import { SelectValueProps } from "./select/select-value.mjs";
+import { Select } from "./select/index.mjs";
+import { ToastActionDetails, ToastActionOptions, ToastCloseDetails, ToastItem, ToastManager, ToastOptions, ToastPriority, ToastPromiseOptions, createToastManager, toast } from "./toast/toast.mjs";
+import { ToastActionProps, ToastActionState } from "./toast/toast-action.mjs";
+import { ToastCloseProps, ToastCloseState } from "./toast/toast-close.mjs";
+import { ToastRootProps, ToastRootState } from "./toast/toast-root.mjs";
+import { ToastDescriptionProps } from "./toast/toast-description.mjs";
+import { ToastTitleProps } from "./toast/toast-title.mjs";
+import { ToastViewportProps, ToastViewportState } from "./toast/toast-viewport.mjs";
+import { Toast } from "./toast/index.mjs";
+import { SliderOrientation, SliderRootProps, SliderRootState, SliderValue, SliderValueChangeDetails, SliderValueCommitDetails } from "./slider/slider-root.mjs";
+import { SliderTrackProps, SliderTrackState } from "./slider/slider-track.mjs";
+import { SliderIndicatorProps, SliderIndicatorState } from "./slider/slider-indicator.mjs";
+import { SliderLabelProps } from "./slider/slider-label.mjs";
+import { SliderThumbProps, SliderThumbState } from "./slider/slider-thumb.mjs";
+import { SliderValueProps, SliderValueState } from "./slider/slider-value.mjs";
+import { Slider } from "./slider/index.mjs";
+export { Accordion, type AccordionItemProps, type AccordionItemState, type AccordionPanelProps, type AccordionPanelState, type AccordionRootExclusiveProps, type AccordionRootMultipleProps, type AccordionRootProps, type AccordionRootState, type AccordionTriggerProps, type AccordionTriggerState, type AccordionValueChangeDetails, type Action, type ActionDetails, type ChangeAction, type ChangeReason, Checkbox, type CheckboxCheckedChangeDetails, CheckboxGroup, type CheckboxGroupItemProps, type CheckboxGroupItemState, type CheckboxGroupLabelProps, type CheckboxGroupParentProps, type CheckboxGroupParentState, type CheckboxGroupRootProps, type CheckboxGroupRootState, type CheckboxGroupValueChangeDetails, type CheckboxProps, type CheckboxState, Combobox, type ComboboxClearProps, type ComboboxClearState, type ComboboxEmptyProps, type ComboboxEmptyState, type ComboboxGroupLabelProps, type ComboboxGroupLabelState, type ComboboxGroupProps, type ComboboxGroupState, type ComboboxInputProps, type ComboboxInputState, type ComboboxInputValueChangeDetails, type ComboboxLabelProps, type ComboboxLabelState, type ComboboxListProps, type ComboboxListState, type ComboboxOpenChangeDetails, type ComboboxOptionProps, type ComboboxOptionState, type ComboboxPopupProps, type ComboboxPopupState, type ComboboxRootProps, type ComboboxRootState, type ComboboxStatusProps, type ComboboxStatusState, type ComboboxTriggerProps, type ComboboxTriggerState, type ComboboxValueChangeDetails, Dialog, type DialogCloseDetails, type DialogCloseProps, type DialogCloseState, type DialogDescriptionProps, type DialogDescriptionState, type DialogFormProps, type DialogFormState, type DialogOpenChangeDetails, type DialogPopupProps, type DialogPopupState, type DialogRootProps, type DialogRootState, type DialogTitleProps, type DialogTitleState, type DialogTriggerProps, type DialogTriggerState, Field, type FieldControlProps, type FieldDescriptionProps, type FieldErrorProps, type FieldErrorValue, type FieldLabelProps, type FieldRootProps, type FieldState, type FieldValidate, type FieldValidity, Form, type FormErrors, type FormRootProps, type FormRootState, type FormSubmitProps, type FormSubmitState, Menu, type MenuAlign, type MenuCheckboxItemProps, type MenuCheckboxItemState, type MenuGroupLabelProps, type MenuGroupLabelState, type MenuGroupProps, type MenuGroupState, type MenuItemDetails, type MenuItemProps, type MenuItemState, type MenuOpenChangeDetails, type MenuPopupProps, type MenuPopupState, type MenuRadioGroupProps, type MenuRadioGroupState, type MenuRadioItemProps, type MenuRadioItemState, type MenuRootProps, type MenuRootState, type MenuSeparatorProps, type MenuSeparatorState, type MenuSide, type MenuSubmenuTriggerProps, type MenuSubmenuTriggerState, type MenuTriggerProps, type MenuTriggerState, Popover, type PopoverAlign, type PopoverCloseProps, type PopoverCloseState, type PopoverDescriptionProps, type PopoverDescriptionState, type PopoverOpenChangeDetails, type PopoverPopupProps, type PopoverPopupState, type PopoverRootProps, type PopoverRootState, type PopoverSide, type PopoverTitleProps, type PopoverTitleState, type PopoverTriggerProps, type PopoverTriggerState, RadioGroup, type RadioGroupItemProps, type RadioGroupItemState, type RadioGroupLabelProps, type RadioGroupRootProps, type RadioGroupRootState, type RadioGroupValueChangeDetails, type RenderProp, Select, type SelectGroupLabelProps, type SelectGroupProps, type SelectOptionProps, type SelectOptionState, type SelectRootProps, type SelectRootState, type SelectSeparatorProps, type SelectTriggerProps, type SelectValueChangeDetails, type SelectValueProps, Slider, type SliderIndicatorProps, type SliderIndicatorState, type SliderLabelProps, type SliderOrientation, type SliderRootProps, type SliderRootState, type SliderThumbProps, type SliderThumbState, type SliderTrackProps, type SliderTrackState, type SliderValue, type SliderValueChangeDetails, type SliderValueCommitDetails, type SliderValueProps, type SliderValueState, type StateValue, Switch, type SwitchCheckedChangeDetails, type SwitchProps, type SwitchState, Tabs, type TabsActivationMode, type TabsIndicatorProps, type TabsIndicatorState, type TabsListProps, type TabsListState, type TabsOrientation, type TabsPanelProps, type TabsPanelState, type TabsRootProps, type TabsRootState, type TabsTabProps, type TabsTabState, type TabsValueChangeDetails, Toast, type ToastActionDetails, type ToastActionOptions, type ToastActionProps, type ToastActionState, type ToastCloseDetails, type ToastCloseProps, type ToastCloseState, type ToastDescriptionProps, type ToastItem, type ToastManager, type ToastOptions, type ToastPriority, type ToastPromiseOptions, type ToastRootProps, type ToastRootState, type ToastTitleProps, type ToastViewportProps, type ToastViewportState, Toggle, type TogglePressedChangeDetails, type ToggleProps, type ToggleState, Tooltip, type TooltipAlign, type TooltipPopupProps, type TooltipPopupState, type TooltipProvides, type TooltipRootProps, type TooltipRootState, type TooltipSide, type TooltipTriggerProps, type TooltipTriggerState, type UrgentChangeAction, createToastManager, toast };

package/dist/index.mjs

@@ -9,4 +9,11 @@ import { Popover } from "./popover/index.mjs";
 import { Menu } from "./menu/index.mjs";
 import { RadioGroup } from "./radio-group/index.mjs";
 import { CheckboxGroup } from "./checkbox-group/index.mjs";
-export { Accordion, Checkbox, CheckboxGroup, Dialog, Menu, Popover, RadioGroup, Switch, Tabs, Toggle, Tooltip };
+import { Select } from "./select/index.mjs";
+import { Combobox } from "./combobox/index.mjs";
+import { createToastManager, toast } from "./toast/toast.mjs";
+import { Toast } from "./toast/index.mjs";
+import { Slider } from "./slider/index.mjs";
+import { Field } from "./field/index.mjs";
+import { Form } from "./form/index.mjs";
+export { Accordion, Checkbox, CheckboxGroup, Combobox, Dialog, Field, Form, Menu, Popover, RadioGroup, Select, Slider, Switch, Tabs, Toast, Toggle, Tooltip, createToastManager, toast };

package/dist/internal/content-focus-probe.mjs

@@ -0,0 +1,42 @@
+"use client";
+import { useCallback, useLayoutEffect, useRef } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/internal/content-focus-probe.tsx
+/**
+* Records, from its layout-effect cleanup, whether focus is inside the popup when the content
+* goes away: React runs a deleted component's layout cleanups before it detaches the host nodes,
+* so `document.activeElement` still names the focused element there.
+*/
+function ContentFocusProbe({ onDetach, children }) {
+	useLayoutEffect(() => onDetach, [onDetach]);
+	return children;
+}
+/**
+* The content probe shared by the popover-like Popups (Popover, Menu) and Dialog.Popup: a
+* library-driven close with `transition` unmounts the content, the focused Close part included,
+* in the close commit, before the layout effect that hides the popup runs, so focus falls to
+* `<body>` and the platform may restore nothing. The probe tells the owner that this happened.
+*/
+function useContentFocusProbe(popupRef) {
+	const lostFocus = useRef(false);
+	const record = useCallback(() => {
+		const element = popupRef.current;
+		if (element === null) return;
+		const active = element.ownerDocument.activeElement;
+		if (active !== null && active !== element && element.contains(active)) lostFocus.current = true;
+	}, [popupRef]);
+	return {
+		wrapContent: useCallback((children) => /* @__PURE__ */ jsx(ContentFocusProbe, {
+			onDetach: record,
+			children
+		}), [record]),
+		hadFocus: useCallback(() => lostFocus.current, []),
+		forget: useCallback(() => {
+			lostFocus.current = false;
+		}, [])
+	};
+}
+//#endregion
+export { useContentFocusProbe };
+
+//# sourceMappingURL=content-focus-probe.mjs.map

package/dist/internal/content-focus-probe.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-focus-probe.mjs","names":[],"sources":["../../src/internal/content-focus-probe.tsx"],"sourcesContent":["\"use client\";\nimport { useCallback, useLayoutEffect, useRef } from \"react\";\nimport type { ReactNode, RefObject } from \"react\";\n\n/**\n * Records, from its layout-effect cleanup, whether focus is inside the popup when the content\n * goes away: React runs a deleted component's layout cleanups before it detaches the host nodes,\n * so `document.activeElement` still names the focused element there.\n */\nfunction ContentFocusProbe({\n  onDetach,\n  children,\n}: {\n  onDetach: () => void;\n  children?: ReactNode;\n}): ReactNode {\n  useLayoutEffect(() => onDetach, [onDetach]);\n  return children;\n}\n\nexport interface ContentFocusProbeHook {\n  /**\n   * Wraps the library-mode content of a top-layer popup: call it only while the content is\n   * shown (`visible ? wrapContent(x) : null`), or inside the `<Activity>` for `keepMounted`.\n   */\n  readonly wrapContent: (children: ReactNode) => ReactNode;\n  /**\n   * Whether the wrapped content unmounted (or was hidden by `<Activity>`) while it held focus\n   * since the last `forget()`. The owner reads it after its close\n   * (design/components/popover.md 6.2 rule 2, design/components/dialog.md 6.2 rule 2).\n   * Handlers and effects only.\n   */\n  readonly hadFocus: () => boolean;\n  /**\n   * Clear the record: on every open, after the owner used it, and whenever the content went\n   * away while the popup stays open (not a close).\n   */\n  readonly forget: () => void;\n}\n\n/**\n * The content probe shared by the popover-like Popups (Popover, Menu) and Dialog.Popup: a\n * library-driven close with `transition` unmounts the content, the focused Close part included,\n * in the close commit, before the layout effect that hides the popup runs, so focus falls to\n * `<body>` and the platform may restore nothing. The probe tells the owner that this happened.\n */\nexport function useContentFocusProbe(\n  popupRef: RefObject<HTMLElement | null>,\n): ContentFocusProbeHook {\n  const lostFocus = useRef(false);\n\n  const record = useCallback(() => {\n    const element = popupRef.current;\n    if (element === null) return;\n    const active = element.ownerDocument.activeElement;\n    if (active !== null && active !== element && element.contains(active)) {\n      lostFocus.current = true;\n    }\n  }, [popupRef]);\n\n  const wrapContent = useCallback(\n    (children: ReactNode): ReactNode => (\n      <ContentFocusProbe onDetach={record}>{children}</ContentFocusProbe>\n    ),\n    [record],\n  );\n  const hadFocus = useCallback(() => lostFocus.current, []);\n  const forget = useCallback(() => {\n    lostFocus.current = false;\n  }, []);\n\n  return { wrapContent, hadFocus, forget };\n}\n"],"mappings":";;;;;;;;;AASA,SAAS,kBAAkB,EACzB,UACA,YAIY;CACZ,sBAAsB,UAAU,CAAC,QAAQ,CAAC;CAC1C,OAAO;AACT;;;;;;;AA4BA,SAAgB,qBACd,UACuB;CACvB,MAAM,YAAY,OAAO,KAAK;CAE9B,MAAM,SAAS,kBAAkB;EAC/B,MAAM,UAAU,SAAS;EACzB,IAAI,YAAY,MAAM;EACtB,MAAM,SAAS,QAAQ,cAAc;EACrC,IAAI,WAAW,QAAQ,WAAW,WAAW,QAAQ,SAAS,MAAM,GAClE,UAAU,UAAU;CAExB,GAAG,CAAC,QAAQ,CAAC;CAab,OAAO;EAAE,aAXW,aACjB,aACC,oBAAC,mBAAD;GAAmB,UAAU;GAAS;EAA4B,CAAA,GAEpE,CAAC,MAAM,CAOU;EAAG,UALL,kBAAkB,UAAU,SAAS,CAAC,CAK1B;EAAG,QAJjB,kBAAkB;GAC/B,UAAU,UAAU;EACtB,GAAG,CAAC,CAEiC;CAAE;AACzC"}

package/dist/internal/field-context.d.mts

@@ -0,0 +1,19 @@
+import { FieldValidity } from "./validity.mjs";
+//#region src/internal/field-context.d.ts
+/** The state every Field part receives (design/components/field-form.md 4.1). */
+export interface FieldState {
+  /** An error is shown: the control matches `:user-invalid`, or a server error for this field is shown. */
+  readonly invalid: boolean;
+  /** The messages shown: `[validationMessage]` for a native constraint, the strings `validate` returned for a custom one, the server's strings for a server error; `[]` while valid. */
+  readonly messages: readonly string[];
+  /** A snapshot of the control's `ValidityState` (all valid on the server and before the first read). */
+  readonly validity: FieldValidity;
+  /** `Field.Root disabled` or the control's own `disabled`. */
+  readonly disabled: boolean;
+  /** `Field.Root required` or the control's own `required`. */
+  readonly required: boolean;
+  /** The enclosing form's submission is in flight (`useFormStatus().pending`); `false` outside a form. */
+  readonly pending: boolean;
+}
+//#endregion
+//# sourceMappingURL=field-context.d.mts.map

package/dist/internal/field-context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-context.d.mts","names":[],"sources":["../../src/internal/field-context.ts"],"mappings":";;;iBAKiB;;WAEN;;WAEA;;WAEA,UAAU;;WAEV;;WAEA;;WAEA"}

package/dist/internal/field-context.mjs

@@ -0,0 +1,14 @@
+"use client";
+import { createContext, use } from "react";
+//#region src/internal/field-context.ts
+const FieldContext = createContext(null);
+function useFieldContext(part) {
+	const ctx = use(FieldContext);
+	if (ctx === null) throw new Error(`${part} must be rendered inside a Field.Root.`);
+	return ctx;
+}
+const FormContext = createContext(null);
+//#endregion
+export { FieldContext, FormContext, useFieldContext };
+
+//# sourceMappingURL=field-context.mjs.map

package/dist/internal/field-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-context.mjs","names":[],"sources":["../../src/internal/field-context.ts"],"sourcesContent":["\"use client\";\nimport { createContext, use } from \"react\";\nimport type { FieldValidity, FormErrors } from \"./validity.js\";\n\n/** The state every Field part receives (design/components/field-form.md 4.1). */\nexport interface FieldState {\n  /** An error is shown: the control matches `:user-invalid`, or a server error for this field is shown. */\n  readonly invalid: boolean;\n  /** The messages shown: `[validationMessage]` for a native constraint, the strings `validate` returned for a custom one, the server's strings for a server error; `[]` while valid. */\n  readonly messages: readonly string[];\n  /** A snapshot of the control's `ValidityState` (all valid on the server and before the first read). */\n  readonly validity: FieldValidity;\n  /** `Field.Root disabled` or the control's own `disabled`. */\n  readonly disabled: boolean;\n  /** `Field.Root required` or the control's own `required`. */\n  readonly required: boolean;\n  /** The enclosing form's submission is in flight (`useFormStatus().pending`); `false` outside a form. */\n  readonly pending: boolean;\n}\n\nexport interface FieldIds {\n  readonly control: string;\n  readonly label: string;\n  readonly description: string;\n  readonly error: string;\n}\n\n/** What a control reports to its Field (design 7.1). */\nexport interface FieldControlRegistration {\n  /** The element the Field labels, describes and listens to (the input, or a group's fieldset). */\n  readonly element: HTMLElement;\n  /** `<label for>` can target it. Groups report `false`. */\n  readonly labelable: boolean;\n  /** The control's own `required` / `disabled` props (for the Field's `data-*` state). */\n  readonly required: boolean;\n  readonly disabled: boolean;\n}\n\nexport interface FieldContextValue {\n  readonly ids: FieldIds;\n  /** `Field.Root name`. */\n  readonly name: string | undefined;\n  /** `Field.Root disabled` / `required` (the props, not the merged state). */\n  readonly disabled: boolean;\n  readonly required: boolean;\n  readonly state: FieldState;\n  /** The registered control is labelable (default `true`, also before any registration). */\n  readonly labelable: boolean;\n  /** Registers the Field's control; returns the unregister function. The first one wins. */\n  readonly registerControl: (registration: FieldControlRegistration) => () => void;\n  /** A `Field.Error` is mounted (the Field may cancel the platform bubble). */\n  readonly registerError: () => () => void;\n  /**\n   * The control's value changed in the DOM without an `input` / `change` event the Field could\n   * hear (a Combobox selection, a CheckboxGroup's derived `required`, a rolled-back optimistic\n   * value): re-reads the slot and the mirror after the commit that wrote it, and refreshes the\n   * other Fields of the `Form.Root` (cross-field rules). `edit`: the user made the change, so a\n   * shown server error is dismissed as by an `input` event. Call from a layout effect.\n   */\n  readonly notifyChange: (edit: boolean) => void;\n}\n\nexport const FieldContext = createContext<FieldContextValue | null>(null);\n\nexport function useFieldContext(part: string): FieldContextValue {\n  const ctx = use(FieldContext);\n  if (ctx === null) throw new Error(`${part} must be rendered inside a Field.Root.`);\n  return ctx;\n}\n\n/** What a Field registers with its Form (design 3.5). */\nexport interface FormFieldRegistration {\n  /** The control, or a group's first enabled (or checked) member. */\n  readonly getFocusTarget: () => HTMLElement | null;\n  /** The Field shows a server error at the latest commit. */\n  readonly showsServerError: () => boolean;\n  /** The server messages shown, for an announcement when focus does not move. */\n  readonly serverMessages: () => readonly string[];\n  /** Re-runs `validate` and re-reads validity (another Field's control changed). */\n  readonly refresh: () => void;\n}\n\nexport interface FormContextValue {\n  readonly errors: FormErrors | undefined;\n  readonly registerField: (registration: FormFieldRegistration) => () => void;\n  /**\n   * The `FormData` of the submission in flight when the Form ran it itself (the intercepted path),\n   * else `null`: the stale-value suppression of design 3.2 item 2 is computed against it.\n   */\n  readonly submittedData: () => FormData | null;\n  /** Refreshes every registered Field except `source` (a change no DOM event carried). */\n  readonly refreshFields: (source: FormFieldRegistration | null) => void;\n}\n\nexport const FormContext = createContext<FormContextValue | null>(null);\n"],"mappings":";;;AA8DA,MAAa,eAAe,cAAwC,IAAI;AAExE,SAAgB,gBAAgB,MAAiC;CAC/D,MAAM,MAAM,IAAI,YAAY;CAC5B,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,GAAG,KAAK,uCAAuC;CACjF,OAAO;AACT;AA0BA,MAAa,cAAc,cAAuC,IAAI"}

package/dist/internal/focus-first-invalid.mjs

@@ -0,0 +1,67 @@
+import { sortByDocumentOrder } from "./validity.mjs";
+//#region src/internal/focus-first-invalid.ts
+/**
+* Speaks `message` through `element.ariaNotify()` where the browser has it (design 5.3: the
+* error is read when focus moves to the control; when focus is already there nothing would be
+* read). Does nothing without `ariaNotify` or with an empty message.
+*/
+function announce(element, message) {
+	const notifying = element;
+	if (message === "" || typeof notifying.ariaNotify !== "function") return;
+	notifying.ariaNotify(message);
+}
+/** The submission attempt in progress: every target added during the current task. */
+let batch = null;
+/**
+* Adds a control whose `invalid` event a Field cancelled during a submission attempt, and
+* focuses the first collected control in document order in a microtask, so the result does not
+* depend on the browser's dispatch order or on how many forms are on the page.
+*
+* The batch lives until the end of the task (a `setTimeout`), not just one microtask: when the
+* browser dispatches the `invalid` events itself (a click on a submit button), it runs a
+* microtask checkpoint after each listener, so the microtask of the first event runs before the
+* second event fires. Every add therefore queues a focus of the batch's first target; later ones
+* re-focus the same element, which is a no-op.
+*
+* Skips the focus when focus moved during the attempt to an element that is not one of the
+* collected targets: a plain `<input required>` with no Field kept the platform's behaviour
+* (bubble and focus), and the library does not fight it.
+*/
+function collectInvalid(target, message = "") {
+	if (target === null) return;
+	if (batch === null) {
+		batch = {
+			targets: [],
+			messages: /* @__PURE__ */ new Map(),
+			activeBefore: target.ownerDocument.activeElement,
+			moved: false,
+			announced: null
+		};
+		setTimeout(() => {
+			batch = null;
+		}, 0);
+	}
+	const current = batch;
+	if (!current.targets.includes(target)) current.targets.push(target);
+	current.messages.set(target, message);
+	queueMicrotask(() => focusFirst(current));
+}
+function focusFirst(current) {
+	const { targets, activeBefore } = current;
+	const connected = targets.filter((t) => t.isConnected);
+	if (connected.length === 0) return;
+	const active = connected[0].ownerDocument.activeElement;
+	if (active !== activeBefore && active !== null && !connected.includes(active)) return;
+	const first = sortByDocumentOrder(connected, (t) => t)[0];
+	if (active !== first) {
+		current.moved = true;
+		first.focus();
+	} else if (!current.moved && current.announced !== first) {
+		current.announced = first;
+		announce(first, current.messages.get(first) ?? "");
+	}
+}
+//#endregion
+export { announce, collectInvalid };
+
+//# sourceMappingURL=focus-first-invalid.mjs.map

package/dist/internal/focus-first-invalid.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-first-invalid.mjs","names":[],"sources":["../../src/internal/focus-first-invalid.ts"],"sourcesContent":["// Directive-free: the module-level first-invalid collector (design/components/field-form.md 2.5).\nimport { sortByDocumentOrder } from \"./validity.js\";\n\ninterface Batch {\n  readonly targets: HTMLElement[];\n  /** The message each target's Field shows, for the announcement when focus does not move. */\n  readonly messages: Map<HTMLElement, string>;\n  /** `document.activeElement` when the first target arrived. */\n  readonly activeBefore: Element | null;\n  /** The batch moved focus (later microtasks then re-focus, never announce). */\n  moved: boolean;\n  /** The target already announced. */\n  announced: HTMLElement | null;\n}\n\ntype NotifyingElement = HTMLElement & { ariaNotify?: (announcement: string) => void };\n\n/**\n * Speaks `message` through `element.ariaNotify()` where the browser has it (design 5.3: the\n * error is read when focus moves to the control; when focus is already there nothing would be\n * read). Does nothing without `ariaNotify` or with an empty message.\n */\nexport function announce(element: HTMLElement, message: string): void {\n  const notifying = element as NotifyingElement;\n  if (message === \"\" || typeof notifying.ariaNotify !== \"function\") return;\n  notifying.ariaNotify(message);\n}\n\n/** The submission attempt in progress: every target added during the current task. */\nlet batch: Batch | null = null;\n\n/**\n * Adds a control whose `invalid` event a Field cancelled during a submission attempt, and\n * focuses the first collected control in document order in a microtask, so the result does not\n * depend on the browser's dispatch order or on how many forms are on the page.\n *\n * The batch lives until the end of the task (a `setTimeout`), not just one microtask: when the\n * browser dispatches the `invalid` events itself (a click on a submit button), it runs a\n * microtask checkpoint after each listener, so the microtask of the first event runs before the\n * second event fires. Every add therefore queues a focus of the batch's first target; later ones\n * re-focus the same element, which is a no-op.\n *\n * Skips the focus when focus moved during the attempt to an element that is not one of the\n * collected targets: a plain `<input required>` with no Field kept the platform's behaviour\n * (bubble and focus), and the library does not fight it.\n */\nexport function collectInvalid(target: HTMLElement | null, message = \"\"): void {\n  if (target === null) return;\n  if (batch === null) {\n    batch = {\n      targets: [],\n      messages: new Map(),\n      activeBefore: target.ownerDocument.activeElement,\n      moved: false,\n      announced: null,\n    };\n    setTimeout(() => {\n      batch = null;\n    }, 0);\n  }\n  const current = batch;\n  if (!current.targets.includes(target)) current.targets.push(target);\n  current.messages.set(target, message);\n  queueMicrotask(() => focusFirst(current));\n}\n\nfunction focusFirst(current: Batch): void {\n  const { targets, activeBefore } = current;\n  const connected = targets.filter((t) => t.isConnected);\n  if (connected.length === 0) return;\n  const active = connected[0]!.ownerDocument.activeElement;\n  if (active !== activeBefore && active !== null && !connected.includes(active as HTMLElement)) {\n    return;\n  }\n  const first = sortByDocumentOrder(connected, (t) => t)[0]!;\n  if (active !== first) {\n    current.moved = true;\n    first.focus();\n  } else if (!current.moved && current.announced !== first) {\n    // Focus was already on the first invalid control (an implicit submission with Enter): the\n    // cancelled bubble was the only announcement, so speak the message instead.\n    current.announced = first;\n    announce(first, current.messages.get(first) ?? \"\");\n  }\n}\n"],"mappings":";;;;;;;AAsBA,SAAgB,SAAS,SAAsB,SAAuB;CACpE,MAAM,YAAY;CAClB,IAAI,YAAY,MAAM,OAAO,UAAU,eAAe,YAAY;CAClE,UAAU,WAAW,OAAO;AAC9B;;AAGA,IAAI,QAAsB;;;;;;;;;;;;;;;;AAiB1B,SAAgB,eAAe,QAA4B,UAAU,IAAU;CAC7E,IAAI,WAAW,MAAM;CACrB,IAAI,UAAU,MAAM;EAClB,QAAQ;GACN,SAAS,CAAC;GACV,0BAAU,IAAI,IAAI;GAClB,cAAc,OAAO,cAAc;GACnC,OAAO;GACP,WAAW;EACb;EACA,iBAAiB;GACf,QAAQ;EACV,GAAG,CAAC;CACN;CACA,MAAM,UAAU;CAChB,IAAI,CAAC,QAAQ,QAAQ,SAAS,MAAM,GAAG,QAAQ,QAAQ,KAAK,MAAM;CAClE,QAAQ,SAAS,IAAI,QAAQ,OAAO;CACpC,qBAAqB,WAAW,OAAO,CAAC;AAC1C;AAEA,SAAS,WAAW,SAAsB;CACxC,MAAM,EAAE,SAAS,iBAAiB;CAClC,MAAM,YAAY,QAAQ,QAAQ,MAAM,EAAE,WAAW;CACrD,IAAI,UAAU,WAAW,GAAG;CAC5B,MAAM,SAAS,UAAU,EAAE,CAAE,cAAc;CAC3C,IAAI,WAAW,gBAAgB,WAAW,QAAQ,CAAC,UAAU,SAAS,MAAqB,GACzF;CAEF,MAAM,QAAQ,oBAAoB,YAAY,MAAM,CAAC,CAAC,CAAC;CACvD,IAAI,WAAW,OAAO;EACpB,QAAQ,QAAQ;EAChB,MAAM,MAAM;CACd,OAAO,IAAI,CAAC,QAAQ,SAAS,QAAQ,cAAc,OAAO;EAGxD,QAAQ,YAAY;EACpB,SAAS,OAAO,QAAQ,SAAS,IAAI,KAAK,KAAK,EAAE;CACnD;AACF"}

package/dist/internal/form-status-watcher.mjs

@@ -0,0 +1,31 @@
+"use client";
+import { useEffect, useRef } from "react";
+import { useFormStatus } from "react-dom";
+//#region src/internal/form-status-watcher.tsx
+/**
+* Observes React's form channel (Dialog design 8.1, Field/Form design 3.2): rendered inside a
+* `<form>`, `useFormStatus().pending` covers the action's whole transition, including the
+* Suspense wait of what it re-renders. On `true → false` the submission settled without throwing
+* (a rejection unmounts the form through the nearest Error Boundary, so the edge is never seen).
+* Used by `Dialog.Form` and `Form.Root`.
+*/
+function FormStatusWatcher({ onPendingChange, onSettled }) {
+	const { pending } = useFormStatus();
+	const previous = useRef(false);
+	useEffect(() => {
+		const was = previous.current;
+		previous.current = pending;
+		if (was === pending) return;
+		onPendingChange(pending);
+		if (was && !pending) onSettled();
+	}, [
+		pending,
+		onPendingChange,
+		onSettled
+	]);
+	return null;
+}
+//#endregion
+export { FormStatusWatcher };
+
+//# sourceMappingURL=form-status-watcher.mjs.map

package/dist/internal/form-status-watcher.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-status-watcher.mjs","names":[],"sources":["../../src/internal/form-status-watcher.tsx"],"sourcesContent":["\"use client\";\nimport { useEffect, useRef } from \"react\";\nimport { useFormStatus } from \"react-dom\";\n\nexport interface FormStatusWatcherProps {\n  readonly onPendingChange: (pending: boolean) => void;\n  readonly onSettled: () => void;\n}\n\n/**\n * Observes React's form channel (Dialog design 8.1, Field/Form design 3.2): rendered inside a\n * `<form>`, `useFormStatus().pending` covers the action's whole transition, including the\n * Suspense wait of what it re-renders. On `true → false` the submission settled without throwing\n * (a rejection unmounts the form through the nearest Error Boundary, so the edge is never seen).\n * Used by `Dialog.Form` and `Form.Root`.\n */\nexport function FormStatusWatcher({ onPendingChange, onSettled }: FormStatusWatcherProps) {\n  const { pending } = useFormStatus();\n  const previous = useRef(false);\n  useEffect(() => {\n    const was = previous.current;\n    previous.current = pending;\n    if (was === pending) return;\n    onPendingChange(pending);\n    if (was && !pending) onSettled();\n  }, [pending, onPendingChange, onSettled]);\n  return null;\n}\n"],"mappings":";;;;;;;;;;;AAgBA,SAAgB,kBAAkB,EAAE,iBAAiB,aAAqC;CACxF,MAAM,EAAE,YAAY,cAAc;CAClC,MAAM,WAAW,OAAO,KAAK;CAC7B,gBAAgB;EACd,MAAM,MAAM,SAAS;EACrB,SAAS,UAAU;EACnB,IAAI,QAAQ,SAAS;EACrB,gBAAgB,OAAO;EACvB,IAAI,OAAO,CAAC,SAAS,UAAU;CACjC,GAAG;EAAC;EAAS;EAAiB;CAAS,CAAC;CACxC,OAAO;AACT"}

package/dist/internal/modal-registry.mjs

@@ -0,0 +1,39 @@
+//#region src/internal/modal-registry.ts
+const stack = [];
+const listeners = /* @__PURE__ */ new Set();
+function notify() {
+	for (const listener of [...listeners]) listener();
+}
+/** Records `dialog` as the topmost open modal dialog (moves it to the top if already present). */
+function pushModal(dialog) {
+	const index = stack.indexOf(dialog);
+	if (index !== -1 && index === stack.length - 1) return;
+	if (index !== -1) stack.splice(index, 1);
+	stack.push(dialog);
+	notify();
+}
+/** Forgets `dialog` (closed or unmounted). */
+function removeModal(dialog) {
+	const index = stack.indexOf(dialog);
+	if (index === -1) return;
+	stack.splice(index, 1);
+	notify();
+}
+function subscribeModals(listener) {
+	listeners.add(listener);
+	return () => {
+		listeners.delete(listener);
+	};
+}
+/** The topmost open modal dialog the library opened, or `null`. */
+function getTopmostModal() {
+	return stack.at(-1) ?? null;
+}
+/** The server snapshot: nothing is open on the server. */
+function getServerTopmostModal() {
+	return null;
+}
+//#endregion
+export { getServerTopmostModal, getTopmostModal, pushModal, removeModal, subscribeModals };
+
+//# sourceMappingURL=modal-registry.mjs.map

package/dist/internal/modal-registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"modal-registry.mjs","names":[],"sources":["../../src/internal/modal-registry.ts"],"sourcesContent":["// No \"use client\" directive: a plain module-level store, no React and no DOM calls\n// (design/components/toast.md 4.3, conventions 3.5 \"module-level registry\").\n//\n// The stack of open modal `<dialog>` elements the library's Dialog opened. A top-layer element\n// outside the topmost modal dialog is inert and absent from the accessibility tree, so Toast's\n// Viewport portals its region into the topmost one. Writers (`use-modal-registration.ts`) run\n// in layout effects and platform event listeners, never during render; readers subscribe through\n// `useSyncExternalStore` with a server snapshot of `null`. Never the source of truth for a\n// component's own state.\n\nconst stack: Element[] = [];\nconst listeners = new Set<() => void>();\n\nfunction notify(): void {\n  for (const listener of [...listeners]) listener();\n}\n\n/** Records `dialog` as the topmost open modal dialog (moves it to the top if already present). */\nexport function pushModal(dialog: Element): void {\n  const index = stack.indexOf(dialog);\n  if (index !== -1 && index === stack.length - 1) return;\n  if (index !== -1) stack.splice(index, 1);\n  stack.push(dialog);\n  notify();\n}\n\n/** Forgets `dialog` (closed or unmounted). */\nexport function removeModal(dialog: Element): void {\n  const index = stack.indexOf(dialog);\n  if (index === -1) return;\n  stack.splice(index, 1);\n  notify();\n}\n\nexport function subscribeModals(listener: () => void): () => void {\n  listeners.add(listener);\n  return () => {\n    listeners.delete(listener);\n  };\n}\n\n/** The topmost open modal dialog the library opened, or `null`. */\nexport function getTopmostModal(): Element | null {\n  return stack.at(-1) ?? null;\n}\n\n/** The server snapshot: nothing is open on the server. */\nexport function getServerTopmostModal(): Element | null {\n  return null;\n}\n"],"mappings":";AAUA,MAAM,QAAmB,CAAC;AAC1B,MAAM,4BAAY,IAAI,IAAgB;AAEtC,SAAS,SAAe;CACtB,KAAK,MAAM,YAAY,CAAC,GAAG,SAAS,GAAG,SAAS;AAClD;;AAGA,SAAgB,UAAU,QAAuB;CAC/C,MAAM,QAAQ,MAAM,QAAQ,MAAM;CAClC,IAAI,UAAU,MAAM,UAAU,MAAM,SAAS,GAAG;CAChD,IAAI,UAAU,IAAI,MAAM,OAAO,OAAO,CAAC;CACvC,MAAM,KAAK,MAAM;CACjB,OAAO;AACT;;AAGA,SAAgB,YAAY,QAAuB;CACjD,MAAM,QAAQ,MAAM,QAAQ,MAAM;CAClC,IAAI,UAAU,IAAI;CAClB,MAAM,OAAO,OAAO,CAAC;CACrB,OAAO;AACT;AAEA,SAAgB,gBAAgB,UAAkC;CAChE,UAAU,IAAI,QAAQ;CACtB,aAAa;EACX,UAAU,OAAO,QAAQ;CAC3B;AACF;;AAGA,SAAgB,kBAAkC;CAChD,OAAO,MAAM,GAAG,EAAE,KAAK;AACzB;;AAGA,SAAgB,wBAAwC;CACtD,OAAO;AACT"}

package/dist/internal/platform-attributes.d.mts

@@ -1,3 +1,4 @@
+import * as React from "react";
 //#region src/internal/platform-attributes.d.ts
 declare module "react" {
   interface HTMLAttributes<T> {
@@ -41,6 +42,17 @@ declare module "react" {
     /** `interestfor` on `<area href>` (Chromium 142+). Not in `@types/react` 19.3.0 (DefinitelyTyped #74664). */
     interestfor?: string | undefined;
   }
+  namespace JSX {
+    interface IntrinsicElements {
+      /**
+       * `<selectedcontent>` (customizable select: Chromium 135+, Safari 27): inside a select's
+       * `<button>`, the browser clones the selected option's content into it. React renders the
+       * unknown lowercase tag verbatim on client and server. `Select.Value` renders it.
+       * Not in `@types/react` 19.3.0 (no DefinitelyTyped issue filed as of 2026-10-17).
+       */
+      selectedcontent: React.DetailedHTMLProps<React.HTMLAttributes<HTMLElement>, HTMLElement>;
+    }
+  }
   interface CSSProperties {
     /** `interest-delay` shorthand (Chromium 142+). Not in `csstype` 3.2.3. */
     interestDelay?: string | undefined;
@@ -51,5 +63,4 @@ declare module "react" {
   }
 }
 //#endregion
-export {};
 //# sourceMappingURL=platform-attributes.d.mts.map

package/dist/internal/platform-attributes.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-attributes.d.mts","names":[],"sources":["../../src/internal/platform-attributes.ts"],"mappings":";;YAkBY,eAAe;;;;;;IAMvB;;;;;;IAMA;;YAGQ,qBAAqB;;;;;;IAM7B;;;;;IAKA;;;;;;IAMA;;YAWQ,qBAAqB;;IAE7B;;YAGQ,mBAAmB;;IAE3B;;YAGQ;;IAER;;IAEA;;IAEA"}
+{"version":3,"file":"platform-attributes.d.mts","names":[],"sources":["../../src/internal/platform-attributes.ts"],"mappings":";;;YAkBY,eAAe;;;;;;IAMvB;;;;;;IAMA;;YAGQ,qBAAqB;;;;;;IAM7B;;;;;IAKA;;;;;;IAMA;;YAWQ,qBAAqB;;IAE7B;;YAGQ,mBAAmB;;IAE3B;;YAGQ;cACE;;;;;;;MAOR,iBAAiB,MAAM,kBAAkB,MAAM,eAAe,cAAc;;;YAItE;;IAER;;IAEA;;IAEA"}

package/dist/internal/types.d.mts

@@ -13,6 +13,14 @@ export interface ActionDetails {
 }
 /** An action called with the next value of a controllable state. */
 export type ChangeAction<T, Details extends ActionDetails = ActionDetails> = Action<[next: T, details: Details]>;
+/**
+ * A change action the library calls **synchronously, outside any Transition, and does not
+ * await**: the urgent lane (conventions 2.6; first used by Combobox's `inputValueChangeAction`).
+ * The body runs during the DOM event, so `(next) => setText(next)` is an urgent update, which is
+ * what a controlled text input needs. Nothing is pending or optimistic for it; a returned promise
+ * is ignored (development warns once).
+ */
+export type UrgentChangeAction<T, Details extends ActionDetails = ActionDetails> = (next: T, details: Details) => void;
 /**
  * Why a change action was dispatched (conventions 2.2). One library-wide vocabulary: every
  * `<Component><State>ChangeDetails` that exposes `reason` declares it with this type.
@@ -24,8 +32,10 @@ export type ChangeAction<T, Details extends ActionDetails = ActionDetails> = Act
  *   `details.event` is the platform's `close` event. Dialog is the first component to use it.
  * - `"platform"`: the browser changed the state itself: find-in-page, a form reset (`event` is
  *   the `reset` event), or interaction before hydration found at mount (`event` is `undefined`).
+ * - `"timeout"`: the library's own timer closed the component; no user gesture and no platform
+ *   event (`event` is `undefined`). Toast's auto-dismiss is the only user.
  */
-export type ChangeReason = "activate" | "dismiss" | "platform";
+export type ChangeReason = "activate" | "dismiss" | "platform" | "timeout";
 /** A prop value that is either a plain value or a function of the part's state. */
 export type StateValue<T, State> = T | ((state: State) => T);
 /**

package/dist/internal/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/internal/types.ts"],"mappings":";;;;;;;;YAQY,OAAO,4CAA4C,MAAM;iBAEpD;;WAEN,OAAO;;;YAIN,aAAa,GAAG,gBAAgB,gBAAgB,iBAAiB,QAC1E,MAAM,GAAG,SAAS;;;;;;;;;;;;;YAeT;;YAGA,WAAW,GAAG,SAAS,MAAM,OAAO,UAAU;;;;;;YAO9C,WAAW,OAAO,SAC1B,aAAa,QAAQ,YACnB,OAAO,OAAO,OAAO,UAAU"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/internal/types.ts"],"mappings":";;;;;;;;YAQY,OAAO,4CAA4C,MAAM;iBAEpD;;WAEN,OAAO;;;YAIN,aAAa,GAAG,gBAAgB,gBAAgB,iBAAiB,QAC1E,MAAM,GAAG,SAAS;;;;;;;;YAUT,mBAAmB,GAAG,gBAAgB,gBAAgB,kBAChE,MAAM,GACN,SAAS;;;;;;;;;;;;;;;YAiBC;;YAGA,WAAW,GAAG,SAAS,MAAM,OAAO,UAAU;;;;;;YAO9C,WAAW,OAAO,SAC1B,aAAa,QAAQ,YACnB,OAAO,OAAO,OAAO,UAAU"}