@funstack/ui 0.0.0-stage → 0.1.0-alpha.1

package/dist/dialog/dialog-title.d.mts

@@ -0,0 +1,23 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { DialogPopupState } from "./dialog-popup.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/dialog/dialog-title.d.ts
+export type DialogTitleState = DialogPopupState;
+export interface DialogTitleProps extends Omit<ComponentPropsWithRef<"h2">, "id" | "className" | "style" | "children"> {
+  className?: StateValue<string | undefined, DialogTitleState>;
+  style?: StateValue<CSSProperties | undefined, DialogTitleState>;
+  children?: StateValue<ReactNode, DialogTitleState>;
+  /** `render={<h3 />}` changes the heading level. */
+  render?: RenderProp<ComponentPropsWithRef<"h2">, DialogTitleState>;
+}
+/**
+ * The dialog's name: an `<h2>` whose id the Popup references with `aria-labelledby`.
+ *
+ * Owned key (conventions 1.2): `id`.
+ */
+export declare function DialogTitle({ className, style, children, render, ...rest }: DialogTitleProps): ReactNode;
+export declare namespace DialogTitle {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=dialog-title.d.mts.map

package/dist/dialog/dialog-title.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-title.d.mts","names":[],"sources":["../../src/dialog/dialog-title.tsx"],"mappings":";;;;YAOY,mBAAmB;iBAEd,yBAAyB,KACxC;EAGA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;EAC9C,WAAW,WAAW,WAAW;;EAEjC,SAAS,WAAW,6BAA6B;;;;;;;wBAQnC,cAAc,WAAW,OAAO,UAAU,WAAW,QAAQ,mBAAgB;yBAA7E"}

package/dist/dialog/dialog-title.mjs

@@ -0,0 +1,31 @@
+"use client";
+import { useRender } from "../internal/use-render.mjs";
+import { useDialogContext } from "./dialog-context.mjs";
+//#region src/dialog/dialog-title.tsx
+/**
+* The dialog's name: an `<h2>` whose id the Popup references with `aria-labelledby`.
+*
+* Owned key (conventions 1.2): `id`.
+*/
+function DialogTitle({ className, style, children, render, ...rest }) {
+	const ctx = useDialogContext("Dialog.Title");
+	const state = {
+		open: ctx.committed,
+		modal: ctx.modal
+	};
+	return useRender({
+		defaultElement: "h2",
+		render,
+		state,
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: { id: ctx.ids.title }
+	});
+}
+DialogTitle.displayName = "DialogTitle";
+//#endregion
+export { DialogTitle };
+
+//# sourceMappingURL=dialog-title.mjs.map

package/dist/dialog/dialog-title.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-title.mjs","names":[],"sources":["../../src/dialog/dialog-title.tsx"],"sourcesContent":["\"use client\";\nimport type { ComponentPropsWithRef, CSSProperties, ReactNode } from \"react\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { useRender } from \"../internal/use-render.js\";\nimport { useDialogContext } from \"./dialog-context.js\";\nimport type { DialogPopupState } from \"./dialog-popup.js\";\n\nexport type DialogTitleState = DialogPopupState;\n\nexport interface DialogTitleProps extends Omit<\n  ComponentPropsWithRef<\"h2\">,\n  \"id\" | \"className\" | \"style\" | \"children\"\n> {\n  className?: StateValue<string | undefined, DialogTitleState>;\n  style?: StateValue<CSSProperties | undefined, DialogTitleState>;\n  children?: StateValue<ReactNode, DialogTitleState>;\n  /** `render={<h3 />}` changes the heading level. */\n  render?: RenderProp<ComponentPropsWithRef<\"h2\">, DialogTitleState>;\n}\n\n/**\n * The dialog's name: an `<h2>` whose id the Popup references with `aria-labelledby`.\n *\n * Owned key (conventions 1.2): `id`.\n */\nexport function DialogTitle({ className, style, children, render, ...rest }: DialogTitleProps) {\n  const ctx = useDialogContext(\"Dialog.Title\");\n  const state: DialogTitleState = { open: ctx.committed, modal: ctx.modal };\n  return useRender<ComponentPropsWithRef<\"h2\">, DialogTitleState>({\n    defaultElement: \"h2\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps: { id: ctx.ids.title },\n  });\n}\n\nDialogTitle.displayName = \"DialogTitle\";\n"],"mappings":";;;;;;;;;AAyBA,SAAgB,YAAY,EAAE,WAAW,OAAO,UAAU,QAAQ,GAAG,QAA0B;CAC7F,MAAM,MAAM,iBAAiB,cAAc;CAC3C,MAAM,QAA0B;EAAE,MAAM,IAAI;EAAW,OAAO,IAAI;CAAM;CACxE,OAAO,UAAyD;EAC9D,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA,OAAO;EACP,cAAc,EAAE,IAAI,IAAI,IAAI,MAAM;CACpC,CAAC;AACH;AAEA,YAAY,cAAc"}

package/dist/dialog/dialog-trigger.d.mts

@@ -0,0 +1,39 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/dialog/dialog-trigger.d.ts
+export interface DialogTriggerState {
+  /** Optimistic open state (library mode); `false` in JS-free mode. */
+  readonly open: boolean;
+  /**
+   * The Root's transition is pending: an open in flight, a close notification in flight, or a
+   * re-open requested while a close notification is still settling.
+   */
+  readonly pending: boolean;
+  readonly disabled: boolean;
+}
+export interface DialogTriggerProps extends Omit<ComponentPropsWithRef<"button">, "onClick" | "className" | "style" | "children"> {
+  /** Native `disabled`: a disabled button is not a valid invoker and never dispatches. */
+  disabled?: boolean;
+  className?: StateValue<string | undefined, DialogTriggerState>;
+  style?: StateValue<CSSProperties | undefined, DialogTriggerState>;
+  /** Rendered from optimistic state; must not suspend. */
+  children?: StateValue<ReactNode, DialogTriggerState>;
+  /** Should render a `<button>`; another element works only in library mode (click handler). */
+  render?: RenderProp<ComponentPropsWithRef<"button">, DialogTriggerState>;
+}
+/**
+ * The opener: `<button type="button" commandfor command="show-modal">`. In JS-free mode the
+ * browser runs the command. In library mode the click is cancelled (so the command does not run)
+ * and dispatched through the Root's transition; the button shows optimistic `data-open` and
+ * `data-pending` until the dialog has opened. Non-modal dialogs have no command and always use a
+ * click handler (`show()`).
+ *
+ * Owned keys (conventions 1.2): `type` (on a `<button>` only), `disabled`, `commandfor`,
+ * `command`, `onClick`, `data-open`, `data-pending`, `data-disabled`.
+ */
+export declare function DialogTrigger({ disabled, className, style, children, render, ...rest }: DialogTriggerProps): ReactNode;
+export declare namespace DialogTrigger {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=dialog-trigger.d.mts.map

package/dist/dialog/dialog-trigger.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-trigger.d.mts","names":[],"sources":["../../src/dialog/dialog-trigger.tsx"],"mappings":";;;iBASiB;;WAEN;;;;;WAKA;WACA;;iBAGM,2BAA2B,KAC1C;;EAIA;EACA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;;EAE9C,WAAW,WAAW,WAAW;;EAEjC,SAAS,WAAW,iCAAiC;;;;;;;;;;;;wBAevC,gBACd,UACA,WACA,OACA,UACA,WACG,QACF,qBAAkB;yBAPL"}

package/dist/dialog/dialog-trigger.mjs

@@ -0,0 +1,80 @@
+"use client";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { rendersButton, useRender } from "../internal/use-render.mjs";
+import { useDialogContext } from "./dialog-context.mjs";
+import { useCallback, useEffect } from "react";
+//#region src/dialog/dialog-trigger.tsx
+const isDev = process.env.NODE_ENV !== "production";
+/**
+* The opener: `<button type="button" commandfor command="show-modal">`. In JS-free mode the
+* browser runs the command. In library mode the click is cancelled (so the command does not run)
+* and dispatched through the Root's transition; the button shows optimistic `data-open` and
+* `data-pending` until the dialog has opened. Non-modal dialogs have no command and always use a
+* click handler (`show()`).
+*
+* Owned keys (conventions 1.2): `type` (on a `<button>` only), `disabled`, `commandfor`,
+* `command`, `onClick`, `data-open`, `data-pending`, `data-disabled`.
+*/
+function DialogTrigger({ disabled = false, className, style, children, render, ...rest }) {
+	const ctx = useDialogContext("Dialog.Trigger");
+	const isLibrary = ctx.mode === "library";
+	const { modal, ids, triggerRef, dialogRef } = ctx;
+	const state = {
+		open: ctx.optimistic,
+		pending: ctx.pending,
+		disabled
+	};
+	const libraryRef = useCallback((element) => {
+		if (isDev && !isLibrary && modal && element.tagName !== "BUTTON") console.error(`Dialog.Trigger: rendered a <${element.tagName.toLowerCase()}> in JS-free mode. Only a <button> runs \`command="show-modal"\`; this trigger will not open the dialog. Render a <button>, or put the Dialog in library mode (\`defaultOpen={false}\`).`);
+		triggerRef.current = element;
+		return () => {
+			if (triggerRef.current === element) triggerRef.current = null;
+		};
+	}, [
+		isLibrary,
+		modal,
+		triggerRef
+	]);
+	useEffect(() => {
+		if (!isDev) return;
+		if (document.getElementById(ids.dialog) === null) console.error("Dialog.Trigger: no Dialog.Popup is rendered for this Dialog.Root; the trigger opens nothing.");
+	}, [ids.dialog]);
+	const installClick = isLibrary || !modal;
+	const onClick = (event) => {
+		if (isLibrary) {
+			event.preventDefault();
+			if (disabled) return;
+			ctx.requestOpen(event.nativeEvent, "activate");
+			return;
+		}
+		if (disabled) return;
+		const dialog = dialogRef.current;
+		if (dialog !== null && !dialog.open && dialog.isConnected) dialog.show();
+	};
+	const libraryProps = {
+		...rendersButton(render) && { type: "button" },
+		disabled,
+		commandfor: modal ? ids.dialog : void 0,
+		command: modal ? "show-modal" : void 0,
+		...installClick && { onClick },
+		"data-open": dataAttr(state.open),
+		"data-pending": dataAttr(state.pending),
+		"data-disabled": dataAttr(isLibrary && disabled)
+	};
+	return useRender({
+		defaultElement: "button",
+		render,
+		state,
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps,
+		ref: libraryRef
+	});
+}
+DialogTrigger.displayName = "DialogTrigger";
+//#endregion
+export { DialogTrigger };
+
+//# sourceMappingURL=dialog-trigger.mjs.map

package/dist/dialog/dialog-trigger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog-trigger.mjs","names":[],"sources":["../../src/dialog/dialog-trigger.tsx"],"sourcesContent":["\"use client\";\nimport { useCallback, useEffect } from \"react\";\nimport type { ComponentPropsWithRef, CSSProperties, MouseEvent, ReactNode } from \"react\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { rendersButton, useRender } from \"../internal/use-render.js\";\nimport type { DataAttributes } from \"../internal/use-render.js\";\nimport { useDialogContext } from \"./dialog-context.js\";\n\nexport interface DialogTriggerState {\n  /** Optimistic open state (library mode); `false` in JS-free mode. */\n  readonly open: boolean;\n  /**\n   * The Root's transition is pending: an open in flight, a close notification in flight, or a\n   * re-open requested while a close notification is still settling.\n   */\n  readonly pending: boolean;\n  readonly disabled: boolean;\n}\n\nexport interface DialogTriggerProps extends Omit<\n  ComponentPropsWithRef<\"button\">,\n  \"onClick\" | \"className\" | \"style\" | \"children\"\n> {\n  /** Native `disabled`: a disabled button is not a valid invoker and never dispatches. */\n  disabled?: boolean;\n  className?: StateValue<string | undefined, DialogTriggerState>;\n  style?: StateValue<CSSProperties | undefined, DialogTriggerState>;\n  /** Rendered from optimistic state; must not suspend. */\n  children?: StateValue<ReactNode, DialogTriggerState>;\n  /** Should render a `<button>`; another element works only in library mode (click handler). */\n  render?: RenderProp<ComponentPropsWithRef<\"button\">, DialogTriggerState>;\n}\n\nconst isDev = process.env.NODE_ENV !== \"production\";\n\n/**\n * The opener: `<button type=\"button\" commandfor command=\"show-modal\">`. In JS-free mode the\n * browser runs the command. In library mode the click is cancelled (so the command does not run)\n * and dispatched through the Root's transition; the button shows optimistic `data-open` and\n * `data-pending` until the dialog has opened. Non-modal dialogs have no command and always use a\n * click handler (`show()`).\n *\n * Owned keys (conventions 1.2): `type` (on a `<button>` only), `disabled`, `commandfor`,\n * `command`, `onClick`, `data-open`, `data-pending`, `data-disabled`.\n */\nexport function DialogTrigger({\n  disabled = false,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: DialogTriggerProps) {\n  const ctx = useDialogContext(\"Dialog.Trigger\");\n  const isLibrary = ctx.mode === \"library\";\n  const { modal, ids, triggerRef, dialogRef } = ctx;\n\n  const state: DialogTriggerState = {\n    open: ctx.optimistic,\n    // Every Root dispatch is an open or a close notification and both belong to the Trigger\n    // (design 4.2). Not `optimistic !== committed`: a re-open while a close notification is\n    // still settling has both `true` (the close never committed) and is pending all the same.\n    pending: ctx.pending,\n    disabled,\n  };\n\n  const libraryRef = useCallback(\n    (element: HTMLElement) => {\n      if (isDev && !isLibrary && modal && element.tagName !== \"BUTTON\") {\n        console.error(\n          `Dialog.Trigger: rendered a <${element.tagName.toLowerCase()}> in JS-free mode. Only a ` +\n            '<button> runs `command=\"show-modal\"`; this trigger will not open the dialog. Render ' +\n            \"a <button>, or put the Dialog in library mode (`defaultOpen={false}`).\",\n        );\n      }\n      triggerRef.current = element;\n      return () => {\n        if (triggerRef.current === element) triggerRef.current = null;\n      };\n    },\n    [isLibrary, modal, triggerRef],\n  );\n\n  // A Trigger without a Popup opens nothing (design 14, dev warnings).\n  useEffect(() => {\n    if (!isDev) return;\n    if (document.getElementById(ids.dialog) === null) {\n      console.error(\n        \"Dialog.Trigger: no Dialog.Popup is rendered for this Dialog.Root; the trigger opens nothing.\",\n      );\n    }\n  }, [ids.dialog]);\n\n  // Library mode (both modal and non-modal) and non-modal JS-free mode need a click handler;\n  // modal JS-free mode is the browser's command.\n  const installClick = isLibrary || !modal;\n  const onClick = (event: MouseEvent<HTMLElement>) => {\n    if (isLibrary) {\n      // Cancelling the click cancels the command (it runs as the button's activation\n      // behaviour, only if the click was not cancelled).\n      event.preventDefault();\n      if (disabled) return;\n      ctx.requestOpen(event.nativeEvent, \"activate\");\n      return;\n    }\n    if (disabled) return;\n    const dialog = dialogRef.current;\n    if (dialog !== null && !dialog.open && dialog.isConnected) dialog.show();\n  };\n\n  const libraryProps: ComponentPropsWithRef<\"button\"> & DataAttributes = {\n    // `type` only applies to a <button>; on any other element the key is not owned.\n    ...(rendersButton(render) && { type: \"button\" as const }),\n    // Owned: a render element must not re-enable a disabled Trigger (in JS-free mode the\n    // browser would run its command).\n    disabled,\n    commandfor: modal ? ids.dialog : undefined,\n    command: modal ? \"show-modal\" : undefined,\n    // Only owned when installed, so a render element keeps its own `onClick` in modal JS-free\n    // mode (Accordion's rule).\n    ...(installClick && { onClick }),\n    \"data-open\": dataAttr(state.open),\n    \"data-pending\": dataAttr(state.pending),\n    \"data-disabled\": dataAttr(isLibrary && disabled),\n  };\n\n  return useRender<ComponentPropsWithRef<\"button\">, DialogTriggerState>({\n    defaultElement: \"button\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps,\n    ref: libraryRef,\n  });\n}\n\nDialogTrigger.displayName = \"DialogTrigger\";\n"],"mappings":";;;;;;AAkCA,MAAM,QAAQ,QAAQ,IAAI,aAAa;;;;;;;;;;;AAYvC,SAAgB,cAAc,EAC5B,WAAW,OACX,WACA,OACA,UACA,QACA,GAAG,QACkB;CACrB,MAAM,MAAM,iBAAiB,gBAAgB;CAC7C,MAAM,YAAY,IAAI,SAAS;CAC/B,MAAM,EAAE,OAAO,KAAK,YAAY,cAAc;CAE9C,MAAM,QAA4B;EAChC,MAAM,IAAI;EAIV,SAAS,IAAI;EACb;CACF;CAEA,MAAM,aAAa,aAChB,YAAyB;EACxB,IAAI,SAAS,CAAC,aAAa,SAAS,QAAQ,YAAY,UACtD,QAAQ,MACN,+BAA+B,QAAQ,QAAQ,YAAY,EAAE,yLAG/D;EAEF,WAAW,UAAU;EACrB,aAAa;GACX,IAAI,WAAW,YAAY,SAAS,WAAW,UAAU;EAC3D;CACF,GACA;EAAC;EAAW;EAAO;CAAU,CAC/B;CAGA,gBAAgB;EACd,IAAI,CAAC,OAAO;EACZ,IAAI,SAAS,eAAe,IAAI,MAAM,MAAM,MAC1C,QAAQ,MACN,8FACF;CAEJ,GAAG,CAAC,IAAI,MAAM,CAAC;CAIf,MAAM,eAAe,aAAa,CAAC;CACnC,MAAM,WAAW,UAAmC;EAClD,IAAI,WAAW;GAGb,MAAM,eAAe;GACrB,IAAI,UAAU;GACd,IAAI,YAAY,MAAM,aAAa,UAAU;GAC7C;EACF;EACA,IAAI,UAAU;EACd,MAAM,SAAS,UAAU;EACzB,IAAI,WAAW,QAAQ,CAAC,OAAO,QAAQ,OAAO,aAAa,OAAO,KAAK;CACzE;CAEA,MAAM,eAAiE;EAErE,GAAI,cAAc,MAAM,KAAK,EAAE,MAAM,SAAkB;EAGvD;EACA,YAAY,QAAQ,IAAI,SAAS,KAAA;EACjC,SAAS,QAAQ,eAAe,KAAA;EAGhC,GAAI,gBAAgB,EAAE,QAAQ;EAC9B,aAAa,SAAS,MAAM,IAAI;EAChC,gBAAgB,SAAS,MAAM,OAAO;EACtC,iBAAiB,SAAS,aAAa,QAAQ;CACjD;CAEA,OAAO,UAA+D;EACpE,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA,OAAO;EACP;EACA,KAAK;CACP,CAAC;AACH;AAEA,cAAc,cAAc"}

package/dist/dialog/index.d.mts

@@ -0,0 +1,28 @@
+import "../internal/platform-attributes.mjs";
+import { DialogClose, DialogCloseDetails, DialogCloseProps, DialogCloseState } from "./dialog-close.mjs";
+import { DialogPopup, DialogPopupProps, DialogPopupState } from "./dialog-popup.mjs";
+import { DialogDescription, DialogDescriptionProps, DialogDescriptionState } from "./dialog-description.mjs";
+import { DialogForm, DialogFormProps, DialogFormState } from "./dialog-form.mjs";
+import { DialogOpenChangeDetails, DialogRoot, DialogRootProps, DialogRootState } from "./dialog-root.mjs";
+import { DialogTitle, DialogTitleProps, DialogTitleState } from "./dialog-title.mjs";
+import { DialogTrigger, DialogTriggerProps, DialogTriggerState } from "./dialog-trigger.mjs";
+//#region src/dialog/index.d.ts
+/**
+ * Dialog built on `<dialog>` and Invoker Commands: `Root` (no DOM) > `Trigger`
+ * (`button[command=show-modal]`) + `Popup` (`dialog`) > `Title`, `Description`, `Form`, `Close`.
+ * JS-free when the Root has none of `open` / `defaultOpen` / `openChangeAction`; otherwise
+ * opening is a transition (pending Trigger, content from committed state) and closing is the
+ * browser's, notified through `openChangeAction(false)`.
+ */
+export declare const Dialog: {
+  readonly Root: typeof DialogRoot;
+  readonly Trigger: typeof DialogTrigger;
+  readonly Popup: typeof DialogPopup;
+  readonly Close: typeof DialogClose;
+  readonly Form: typeof DialogForm;
+  readonly Title: typeof DialogTitle;
+  readonly Description: typeof DialogDescription;
+};
+//#endregion
+export type { DialogCloseDetails, DialogCloseProps, DialogCloseState, DialogDescriptionProps, DialogDescriptionState, DialogFormProps, DialogFormState, DialogOpenChangeDetails, DialogPopupProps, DialogPopupState, DialogRootProps, DialogRootState, DialogTitleProps, DialogTitleState, DialogTriggerProps, DialogTriggerState };
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/dialog/index.ts"],"mappings":";;;;;;;;;;;;;;;;qBAkBa;WACX,aAAI;WACJ,gBAAO;WACP,cAAK;WACL,cAAK;WACL,aAAI;WACJ,cAAK;WACL,oBAAW"}

package/dist/dialog/index.mjs

@@ -0,0 +1,28 @@
+import { DialogClose } from "./dialog-close.mjs";
+import { DialogDescription } from "./dialog-description.mjs";
+import { DialogForm } from "./dialog-form.mjs";
+import { DialogPopup } from "./dialog-popup.mjs";
+import { DialogRoot } from "./dialog-root.mjs";
+import { DialogTitle } from "./dialog-title.mjs";
+import { DialogTrigger } from "./dialog-trigger.mjs";
+//#region src/dialog/index.ts
+/**
+* Dialog built on `<dialog>` and Invoker Commands: `Root` (no DOM) > `Trigger`
+* (`button[command=show-modal]`) + `Popup` (`dialog`) > `Title`, `Description`, `Form`, `Close`.
+* JS-free when the Root has none of `open` / `defaultOpen` / `openChangeAction`; otherwise
+* opening is a transition (pending Trigger, content from committed state) and closing is the
+* browser's, notified through `openChangeAction(false)`.
+*/
+const Dialog = {
+	Root: DialogRoot,
+	Trigger: DialogTrigger,
+	Popup: DialogPopup,
+	Close: DialogClose,
+	Form: DialogForm,
+	Title: DialogTitle,
+	Description: DialogDescription
+};
+//#endregion
+export { Dialog };
+
+//# sourceMappingURL=index.mjs.map

package/dist/dialog/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/dialog/index.ts"],"sourcesContent":["// Ships the platform attribute typings (`command`, `commandfor`) with this subpath\n// (conventions 7.4). Type-only: the built JS has no import of it.\nimport \"../internal/platform-attributes.js\";\nimport { DialogClose } from \"./dialog-close.js\";\nimport { DialogDescription } from \"./dialog-description.js\";\nimport { DialogForm } from \"./dialog-form.js\";\nimport { DialogPopup } from \"./dialog-popup.js\";\nimport { DialogRoot } from \"./dialog-root.js\";\nimport { DialogTitle } from \"./dialog-title.js\";\nimport { DialogTrigger } from \"./dialog-trigger.js\";\n\n/**\n * Dialog built on `<dialog>` and Invoker Commands: `Root` (no DOM) > `Trigger`\n * (`button[command=show-modal]`) + `Popup` (`dialog`) > `Title`, `Description`, `Form`, `Close`.\n * JS-free when the Root has none of `open` / `defaultOpen` / `openChangeAction`; otherwise\n * opening is a transition (pending Trigger, content from committed state) and closing is the\n * browser's, notified through `openChangeAction(false)`.\n */\nexport const Dialog = {\n  Root: DialogRoot,\n  Trigger: DialogTrigger,\n  Popup: DialogPopup,\n  Close: DialogClose,\n  Form: DialogForm,\n  Title: DialogTitle,\n  Description: DialogDescription,\n} as const;\n\nexport type { DialogRootProps, DialogRootState, DialogOpenChangeDetails } from \"./dialog-root.js\";\nexport type { DialogTriggerProps, DialogTriggerState } from \"./dialog-trigger.js\";\nexport type { DialogPopupProps, DialogPopupState } from \"./dialog-popup.js\";\nexport type { DialogCloseProps, DialogCloseState, DialogCloseDetails } from \"./dialog-close.js\";\nexport type { DialogFormProps, DialogFormState } from \"./dialog-form.js\";\nexport type { DialogTitleProps, DialogTitleState } from \"./dialog-title.js\";\nexport type { DialogDescriptionProps, DialogDescriptionState } from \"./dialog-description.js\";\n"],"mappings":";;;;;;;;;;;;;;;AAkBA,MAAa,SAAS;CACpB,MAAM;CACN,SAAS;CACT,OAAO;CACP,OAAO;CACP,MAAM;CACN,OAAO;CACP,aAAa;AACf"}

package/dist/index.d.mts

@@ -0,0 +1,60 @@
+import "./internal/platform-attributes.mjs";
+import { Action, ActionDetails, ChangeAction, ChangeReason, RenderProp, StateValue } 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";
+import { AccordionTriggerProps, AccordionTriggerState } from "./accordion/accordion-trigger.mjs";
+import { Accordion } from "./accordion/index.mjs";
+import { CheckboxGroupItemProps, CheckboxGroupItemState } from "./checkbox-group/checkbox-group-item.mjs";
+import { CheckboxGroupRootProps, CheckboxGroupRootState, CheckboxGroupValueChangeDetails } from "./checkbox-group/checkbox-group-root.mjs";
+import { CheckboxGroupLabelProps } from "./checkbox-group/checkbox-group-label.mjs";
+import { CheckboxGroupParentProps, CheckboxGroupParentState } from "./checkbox-group/checkbox-group-parent.mjs";
+import { CheckboxGroup } from "./checkbox-group/index.mjs";
+import { Checkbox, CheckboxCheckedChangeDetails, CheckboxProps, CheckboxState } from "./checkbox/checkbox.mjs";
+import "./checkbox/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";
+import { DialogFormProps, DialogFormState } from "./dialog/dialog-form.mjs";
+import { DialogOpenChangeDetails, DialogRootProps, DialogRootState } from "./dialog/dialog-root.mjs";
+import { DialogTitleProps, DialogTitleState } from "./dialog/dialog-title.mjs";
+import { DialogTriggerProps, DialogTriggerState } from "./dialog/dialog-trigger.mjs";
+import { Dialog } from "./dialog/index.mjs";
+import { Toggle, TogglePressedChangeDetails, ToggleProps, ToggleState } from "./toggle/toggle.mjs";
+import "./toggle/index.mjs";
+import { TabsActivationMode, TabsOrientation } from "./tabs/tabs-context.mjs";
+import { TabsIndicatorProps, TabsIndicatorState } from "./tabs/tabs-indicator.mjs";
+import { TabsListProps, TabsListState } from "./tabs/tabs-list.mjs";
+import { TabsPanelProps, TabsPanelState } from "./tabs/tabs-panel.mjs";
+import { TabsRootProps, TabsRootState, TabsValueChangeDetails } from "./tabs/tabs-root.mjs";
+import { TabsTabProps, TabsTabState } from "./tabs/tabs-tab.mjs";
+import { Tabs } from "./tabs/index.mjs";
+import { TooltipAlign, TooltipPopupProps, TooltipPopupState, TooltipSide } from "./tooltip/tooltip-popup.mjs";
+import { TooltipProvides } from "./tooltip/tooltip-context.mjs";
+import { TooltipRootProps, TooltipRootState } from "./tooltip/tooltip-root.mjs";
+import { TooltipTriggerProps, TooltipTriggerState } from "./tooltip/tooltip-trigger.mjs";
+import { Tooltip } from "./tooltip/index.mjs";
+import { Switch, SwitchCheckedChangeDetails, SwitchProps, SwitchState } from "./switch/switch.mjs";
+import "./switch/index.mjs";
+import { PopoverCloseProps, PopoverCloseState } from "./popover/popover-close.mjs";
+import { PopoverAlign, PopoverPopupProps, PopoverPopupState, PopoverSide } from "./popover/popover-popup.mjs";
+import { PopoverDescriptionProps, PopoverDescriptionState } from "./popover/popover-description.mjs";
+import { PopoverOpenChangeDetails, PopoverRootProps, PopoverRootState } from "./popover/popover-root.mjs";
+import { PopoverTitleProps, PopoverTitleState } from "./popover/popover-title.mjs";
+import { PopoverTriggerProps, PopoverTriggerState } from "./popover/popover-trigger.mjs";
+import { Popover } from "./popover/index.mjs";
+import { MenuItemDetails, MenuItemProps, MenuItemState } from "./menu/menu-item.mjs";
+import { MenuCheckboxItemProps, MenuCheckboxItemState } from "./menu/menu-checkbox-item.mjs";
+import { MenuGroupLabelProps, MenuGroupLabelState, MenuGroupProps, MenuGroupState, MenuSeparatorProps, MenuSeparatorState } from "./menu/menu-group.mjs";
+import { MenuAlign, MenuPopupProps, MenuPopupState, MenuSide } from "./menu/menu-popup.mjs";
+import { MenuRadioGroupProps, MenuRadioGroupState } from "./menu/menu-radio-group.mjs";
+import { MenuRadioItemProps, MenuRadioItemState } from "./menu/menu-radio-item.mjs";
+import { MenuOpenChangeDetails, MenuRootProps, MenuRootState } from "./menu/menu-root.mjs";
+import { MenuTriggerProps, MenuTriggerState } from "./menu/menu-trigger.mjs";
+import { MenuSubmenuTriggerProps, MenuSubmenuTriggerState } from "./menu/menu-submenu-trigger.mjs";
+import { Menu } from "./menu/index.mjs";
+import { RadioGroupItemProps, RadioGroupItemState } from "./radio-group/radio-group-item.mjs";
+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 };

package/dist/index.mjs

@@ -0,0 +1,12 @@
+import { Toggle } from "./toggle/toggle.mjs";
+import { Accordion } from "./accordion/index.mjs";
+import { Tabs } from "./tabs/index.mjs";
+import { Tooltip } from "./tooltip/index.mjs";
+import { Switch } from "./switch/switch.mjs";
+import { Checkbox } from "./checkbox/checkbox.mjs";
+import { Dialog } from "./dialog/index.mjs";
+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 };

package/dist/internal/action-details.mjs

@@ -0,0 +1,47 @@
+//#region src/internal/action-details.ts
+function isDev() {
+	return process.env.NODE_ENV !== "production";
+}
+function rejectEventWrite() {
+	throw new TypeError("`details.event` is a read-only virtual property; it cannot be assigned or defined. Keep the DOM event out of `details` so that it stays serialisable.");
+}
+/**
+* Builds the `details` argument of an action (conventions 2.2).
+*
+* `fields` is a plain, extensible object of serialisable component-specific fields. `event` is a
+* virtual, non-own property served by a Proxy: `details.event` and `"event" in details` work,
+* while `Object.keys`, spread, `JSON.stringify` and React's Server Function serialiser see only
+* the real fields. That is what lets a Server Function be passed directly as an action.
+*
+* Writing `event` (`details.event = x`, `Object.defineProperty(details, "event", ...)`) is
+* rejected so that an own, enumerable `event` can never appear: in development it throws a
+* `TypeError`; in production an assignment is ignored and a `defineProperty` is declined (which
+* makes `Object.defineProperty` throw and `Reflect.defineProperty` return `false`).
+*
+* No `"use client"` directive: this file uses no client-only API, so it is importable from
+* anywhere (conventions 7.1).
+*/
+function createActionDetails(event, fields) {
+	return new Proxy(fields, {
+		get: (target, key, receiver) => key === "event" ? event : Reflect.get(target, key, receiver),
+		has: (target, key) => key === "event" || Reflect.has(target, key),
+		set: (target, key, value, receiver) => {
+			if (key === "event") {
+				if (isDev()) rejectEventWrite();
+				return true;
+			}
+			return Reflect.set(target, key, value, receiver);
+		},
+		defineProperty: (target, key, descriptor) => {
+			if (key === "event") {
+				if (isDev()) rejectEventWrite();
+				return false;
+			}
+			return Reflect.defineProperty(target, key, descriptor);
+		}
+	});
+}
+//#endregion
+export { createActionDetails };
+
+//# sourceMappingURL=action-details.mjs.map

package/dist/internal/action-details.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-details.mjs","names":[],"sources":["../../src/internal/action-details.ts"],"sourcesContent":["import type { ActionDetails } from \"./types.js\";\n\nfunction isDev(): boolean {\n  return process.env.NODE_ENV !== \"production\";\n}\n\nfunction rejectEventWrite(): never {\n  throw new TypeError(\n    \"`details.event` is a read-only virtual property; it cannot be assigned or defined. \" +\n      \"Keep the DOM event out of `details` so that it stays serialisable.\",\n  );\n}\n\n/**\n * Builds the `details` argument of an action (conventions 2.2).\n *\n * `fields` is a plain, extensible object of serialisable component-specific fields. `event` is a\n * virtual, non-own property served by a Proxy: `details.event` and `\"event\" in details` work,\n * while `Object.keys`, spread, `JSON.stringify` and React's Server Function serialiser see only\n * the real fields. That is what lets a Server Function be passed directly as an action.\n *\n * Writing `event` (`details.event = x`, `Object.defineProperty(details, \"event\", ...)`) is\n * rejected so that an own, enumerable `event` can never appear: in development it throws a\n * `TypeError`; in production an assignment is ignored and a `defineProperty` is declined (which\n * makes `Object.defineProperty` throw and `Reflect.defineProperty` return `false`).\n *\n * No `\"use client\"` directive: this file uses no client-only API, so it is importable from\n * anywhere (conventions 7.1).\n */\nexport function createActionDetails<T extends object>(\n  event: Event | undefined,\n  fields: T,\n): T & ActionDetails {\n  return new Proxy(fields, {\n    get: (target, key, receiver) => (key === \"event\" ? event : Reflect.get(target, key, receiver)),\n    has: (target, key) => key === \"event\" || Reflect.has(target, key),\n    set: (target, key, value, receiver) => {\n      if (key === \"event\") {\n        if (isDev()) rejectEventWrite();\n        return true;\n      }\n      return Reflect.set(target, key, value, receiver);\n    },\n    defineProperty: (target, key, descriptor) => {\n      if (key === \"event\") {\n        if (isDev()) rejectEventWrite();\n        return false;\n      }\n      return Reflect.defineProperty(target, key, descriptor);\n    },\n  }) as T & ActionDetails;\n}\n"],"mappings":";AAEA,SAAS,QAAiB;CACxB,OAAO,QAAQ,IAAI,aAAa;AAClC;AAEA,SAAS,mBAA0B;CACjC,MAAM,IAAI,UACR,uJAEF;AACF;;;;;;;;;;;;;;;;;AAkBA,SAAgB,oBACd,OACA,QACmB;CACnB,OAAO,IAAI,MAAM,QAAQ;EACvB,MAAM,QAAQ,KAAK,aAAc,QAAQ,UAAU,QAAQ,QAAQ,IAAI,QAAQ,KAAK,QAAQ;EAC5F,MAAM,QAAQ,QAAQ,QAAQ,WAAW,QAAQ,IAAI,QAAQ,GAAG;EAChE,MAAM,QAAQ,KAAK,OAAO,aAAa;GACrC,IAAI,QAAQ,SAAS;IACnB,IAAI,MAAM,GAAG,iBAAiB;IAC9B,OAAO;GACT;GACA,OAAO,QAAQ,IAAI,QAAQ,KAAK,OAAO,QAAQ;EACjD;EACA,iBAAiB,QAAQ,KAAK,eAAe;GAC3C,IAAI,QAAQ,SAAS;IACnB,IAAI,MAAM,GAAG,iBAAiB;IAC9B,OAAO;GACT;GACA,OAAO,QAAQ,eAAe,QAAQ,KAAK,UAAU;EACvD;CACF,CAAC;AACH"}

package/dist/internal/anchor-position.d.mts

@@ -0,0 +1,7 @@
+//#region src/internal/anchor-position.d.ts
+/** Physical side of the anchor the popup is placed on. */
+export type AnchorSide = "top" | "bottom" | "left" | "right";
+/** Alignment along that side. */
+export type AnchorAlign = "start" | "center" | "end";
+//#endregion
+//# sourceMappingURL=anchor-position.d.mts.map

package/dist/internal/anchor-position.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-position.d.mts","names":[],"sources":["../../src/internal/anchor-position.ts"],"mappings":";;YAQY;;YAEA"}

package/dist/internal/anchor-position.mjs

@@ -0,0 +1,16 @@
+//#region src/internal/anchor-position.ts
+/** Flip to the opposite side, then the other axis, then both, when the popup does not fit. */
+const POSITION_TRY_FALLBACKS = "flip-block, flip-inline, flip-block flip-inline";
+/**
+* The `position-area` for a side and an alignment (physical keywords): `bottom` + `center` is
+* `bottom`, `bottom` + `start` is `bottom span-right`, `right` + `start` is `right span-bottom`,
+* and so on.
+*/
+function positionArea(side, align) {
+	if (align === "center") return side;
+	return `${side} ${side === "top" || side === "bottom" ? align === "start" ? "span-right" : "span-left" : align === "start" ? "span-bottom" : "span-top"}`;
+}
+//#endregion
+export { POSITION_TRY_FALLBACKS, positionArea };
+
+//# sourceMappingURL=anchor-position.mjs.map

package/dist/internal/anchor-position.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor-position.mjs","names":[],"sources":["../../src/internal/anchor-position.ts"],"sourcesContent":["// Placement of a popover against its implicit anchor (the invoker set by `commandfor`,\n// `interestfor` or `showPopover({ source })`): inline `position-area` from a side and an\n// alignment, plus `position-try-fallbacks` that flip it when it does not fit. Shared by Tooltip,\n// Popover and Menu (design/components/tooltip.md 7.1, popover.md 8).\n//\n// No \"use client\" directive: pure functions, importable from anywhere (conventions 7.1).\n\n/** Physical side of the anchor the popup is placed on. */\nexport type AnchorSide = \"top\" | \"bottom\" | \"left\" | \"right\";\n/** Alignment along that side. */\nexport type AnchorAlign = \"start\" | \"center\" | \"end\";\n\n/** Flip to the opposite side, then the other axis, then both, when the popup does not fit. */\nexport const POSITION_TRY_FALLBACKS = \"flip-block, flip-inline, flip-block flip-inline\";\n\n/**\n * The `position-area` for a side and an alignment (physical keywords): `bottom` + `center` is\n * `bottom`, `bottom` + `start` is `bottom span-right`, `right` + `start` is `right span-bottom`,\n * and so on.\n */\nexport function positionArea(side: AnchorSide, align: AnchorAlign): string {\n  if (align === \"center\") return side;\n  const vertical = side === \"top\" || side === \"bottom\";\n  const span = vertical\n    ? align === \"start\"\n      ? \"span-right\"\n      : \"span-left\"\n    : align === \"start\"\n      ? \"span-bottom\"\n      : \"span-top\";\n  return `${side} ${span}`;\n}\n"],"mappings":";;AAaA,MAAa,yBAAyB;;;;;;AAOtC,SAAgB,aAAa,MAAkB,OAA4B;CACzE,IAAI,UAAU,UAAU,OAAO;CAS/B,OAAO,GAAG,KAAK,GARE,SAAS,SAAS,SAAS,WAExC,UAAU,UACR,eACA,cACF,UAAU,UACR,gBACA;AAER"}

package/dist/internal/data-attr.mjs

@@ -0,0 +1,13 @@
+//#region src/internal/data-attr.ts
+/**
+* Boolean data attributes are emitted by presence: `data-x=""` when true, absent when false.
+* react-dom would stringify `true` as `"true"`, so this helper is the only place the presence
+* form is spelled out (conventions 4.1).
+*/
+function dataAttr(flag) {
+	return flag ? "" : void 0;
+}
+//#endregion
+export { dataAttr };
+
+//# sourceMappingURL=data-attr.mjs.map

package/dist/internal/data-attr.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-attr.mjs","names":[],"sources":["../../src/internal/data-attr.ts"],"sourcesContent":["/**\n * Boolean data attributes are emitted by presence: `data-x=\"\"` when true, absent when false.\n * react-dom would stringify `true` as `\"true\"`, so this helper is the only place the presence\n * form is spelled out (conventions 4.1).\n */\nexport function dataAttr(flag: boolean): \"\" | undefined {\n  return flag ? \"\" : undefined;\n}\n"],"mappings":";;;;;;AAKA,SAAgB,SAAS,MAA+B;CACtD,OAAO,OAAO,KAAK,KAAA;AACrB"}

package/dist/internal/merge-props.mjs

@@ -0,0 +1,119 @@
+//#region src/internal/merge-props.ts
+/**
+* ARIA id-reference lists are merged as token lists rather than overridden (conventions 1.2), so
+* a trigger can be described by more than the element the library wires it to.
+*/
+const ID_REFERENCE_LISTS = /* @__PURE__ */ new Set([
+	"aria-labelledby",
+	"aria-describedby",
+	"aria-controls",
+	"aria-owns"
+]);
+function isIdReferenceList(key) {
+	return ID_REFERENCE_LISTS.has(key);
+}
+function isEventHandler(key, value) {
+	return typeof value === "function" && /^on[A-Z]/.test(key);
+}
+function isObjectRef(ref) {
+	return typeof ref === "object" && ref !== null && "current" in ref;
+}
+function attachRef(ref, node) {
+	if (ref === null || ref === void 0) return void 0;
+	if (typeof ref === "function") {
+		const cleanup = ref(node);
+		return typeof cleanup === "function" ? cleanup : () => ref(null);
+	}
+	if (isObjectRef(ref)) {
+		ref.current = node;
+		return () => {
+			ref.current = null;
+		};
+	}
+}
+/**
+* Merges several refs into one callback ref. The callback returns a cleanup function (React 19),
+* so each inner ref is detached through its own cleanup (callback refs that returned one) or by
+* being set to `null`.
+*/
+function mergeRefs(...refs) {
+	return (node) => {
+		const cleanups = refs.map((ref) => attachRef(ref, node));
+		return () => {
+			for (const cleanup of cleanups) cleanup?.();
+		};
+	};
+}
+/** Joins two space-separated id lists, `first` tokens first, without duplicates. */
+function mergeTokenLists(first, second) {
+	const tokens = [];
+	for (const list of [first, second]) {
+		if (typeof list !== "string") continue;
+		for (const token of list.split(/\s+/)) if (token !== "" && !tokens.includes(token)) tokens.push(token);
+	}
+	return tokens.join(" ");
+}
+/**
+* Layers `over` onto `under`, with the rules shared by every layer of the merge:
+*
+* - `className`: concatenated (`under` first).
+* - `style`: merged, `over` wins per property.
+* - `ref`: both attached.
+* - Event handlers: both run; `overFirst` says whether `over`'s runs before `under`'s.
+* - ARIA id-reference lists: token-merged; `overFirst` says whose tokens come first.
+* - Everything else: `over` wins when it defines the prop. `undefined` is "not given" (JSX
+*   optional props are routinely `undefined`), except in an `owned` layer, where a key present
+*   with an `undefined` value removes the prop: the library-controlled layer owns its keys.
+*/
+function layer(under, over, overFirst, owned) {
+	const result = { ...under };
+	for (const key of Object.keys(over)) {
+		const overValue = over[key];
+		const underValue = under[key];
+		if (overValue === void 0) {
+			if (owned) result[key] = void 0;
+			continue;
+		}
+		if (key === "className") result[key] = typeof underValue === "string" && underValue !== "" ? `${underValue} ${String(overValue)}` : overValue;
+		else if (key === "style") result[key] = {
+			...underValue,
+			...overValue
+		};
+		else if (key === "ref") result[key] = underValue === void 0 || underValue === null ? overValue : mergeRefs(underValue, overValue);
+		else if (isEventHandler(key, overValue) && isEventHandler(key, underValue)) {
+			const [first, second] = overFirst ? [overValue, underValue] : [underValue, overValue];
+			result[key] = (...args) => {
+				first(...args);
+				second(...args);
+			};
+		} else if (isIdReferenceList(key) && typeof underValue === "string") result[key] = overFirst ? mergeTokenLists(overValue, underValue) : mergeTokenLists(underValue, overValue);
+		else result[key] = overValue;
+	}
+	return result;
+}
+/**
+* Merges the props for a part's element in the order of conventions 1.2: the part's pass-through
+* props, then the `render` element's props, then the library-controlled attributes on top.
+*
+* - The `render` element wins over pass-through props (`aria-label`, `data-*` from the part's own
+*   props, `type`, ...); the library-controlled attributes (`role`, computed `aria-*` state, id
+*   wiring, `data-*` state, the library's handlers) win over the element.
+* - Library-controlled keys are **owned**: a key present in `libraryProps` with an `undefined`
+*   value removes the attribute, whatever the element or the pass-through props say, so a
+*   `render` element can never re-introduce `data-open`, `aria-disabled`, `name`, ... when the
+*   part computes none. A part that does not own a key in some mode omits the key instead. The
+*   function form of `render` is the way to override library attributes deliberately.
+* - `className` is concatenated (part, element), `style` merged with the element winning.
+* - Event handlers all run: the element's first, then the part's pass-through one, then the
+*   library's.
+* - `aria-labelledby` / `aria-describedby` / `aria-controls` / `aria-owns` are merged as token
+*   lists, the element's tokens first.
+* - `ref`s are all attached.
+*/
+function mergeProps(partProps, elementProps, libraryProps = {}) {
+	return layer(layer(partProps, elementProps, true, false), libraryProps, false, true);
+}
+//#endregion
+export { mergeProps, mergeRefs, mergeTokenLists };
+
+//# sourceMappingURL=merge-props.mjs.map

package/dist/internal/merge-props.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-props.mjs","names":[],"sources":["../../src/internal/merge-props.ts"],"sourcesContent":["import type { CSSProperties, Ref, RefCallback } from \"react\";\n\ntype AnyProps = Record<string, unknown>;\n\n/**\n * ARIA id-reference lists are merged as token lists rather than overridden (conventions 1.2), so\n * a trigger can be described by more than the element the library wires it to.\n */\nconst ID_REFERENCE_LISTS = new Set([\n  \"aria-labelledby\",\n  \"aria-describedby\",\n  \"aria-controls\",\n  \"aria-owns\",\n]);\n\nfunction isIdReferenceList(key: string): boolean {\n  return ID_REFERENCE_LISTS.has(key);\n}\n\nfunction isEventHandler(key: string, value: unknown): value is (...args: unknown[]) => void {\n  return typeof value === \"function\" && /^on[A-Z]/.test(key);\n}\n\nfunction isObjectRef<T>(ref: unknown): ref is { current: T | null } {\n  return typeof ref === \"object\" && ref !== null && \"current\" in ref;\n}\n\nfunction attachRef<T>(ref: Ref<T> | undefined, node: T): (() => void) | undefined {\n  if (ref === null || ref === undefined) return undefined;\n  if (typeof ref === \"function\") {\n    const cleanup = ref(node);\n    return typeof cleanup === \"function\" ? cleanup : () => ref(null);\n  }\n  if (isObjectRef<T>(ref)) {\n    ref.current = node;\n    return () => {\n      ref.current = null;\n    };\n  }\n  return undefined;\n}\n\n/**\n * Merges several refs into one callback ref. The callback returns a cleanup function (React 19),\n * so each inner ref is detached through its own cleanup (callback refs that returned one) or by\n * being set to `null`.\n */\nexport function mergeRefs<T>(...refs: readonly (Ref<T> | undefined)[]): RefCallback<T> {\n  return (node: T) => {\n    const cleanups = refs.map((ref) => attachRef(ref, node));\n    return () => {\n      for (const cleanup of cleanups) cleanup?.();\n    };\n  };\n}\n\n/** Joins two space-separated id lists, `first` tokens first, without duplicates. */\nexport function mergeTokenLists(first: unknown, second: unknown): string {\n  const tokens: string[] = [];\n  for (const list of [first, second]) {\n    if (typeof list !== \"string\") continue;\n    for (const token of list.split(/\\s+/)) {\n      if (token !== \"\" && !tokens.includes(token)) tokens.push(token);\n    }\n  }\n  return tokens.join(\" \");\n}\n\n/**\n * Layers `over` onto `under`, with the rules shared by every layer of the merge:\n *\n * - `className`: concatenated (`under` first).\n * - `style`: merged, `over` wins per property.\n * - `ref`: both attached.\n * - Event handlers: both run; `overFirst` says whether `over`'s runs before `under`'s.\n * - ARIA id-reference lists: token-merged; `overFirst` says whose tokens come first.\n * - Everything else: `over` wins when it defines the prop. `undefined` is \"not given\" (JSX\n *   optional props are routinely `undefined`), except in an `owned` layer, where a key present\n *   with an `undefined` value removes the prop: the library-controlled layer owns its keys.\n */\nfunction layer(under: AnyProps, over: AnyProps, overFirst: boolean, owned: boolean): AnyProps {\n  const result: AnyProps = { ...under };\n\n  for (const key of Object.keys(over)) {\n    const overValue = over[key];\n    const underValue = under[key];\n\n    if (overValue === undefined) {\n      // An explicit `undefined` (not a deletion): `cloneElement` layers the merged props over the\n      // render element's original props, so only an own `undefined` removes the attribute there.\n      if (owned) result[key] = undefined;\n      continue;\n    }\n\n    if (key === \"className\") {\n      result[key] =\n        typeof underValue === \"string\" && underValue !== \"\"\n          ? `${underValue} ${String(overValue)}`\n          : overValue;\n    } else if (key === \"style\") {\n      result[key] = {\n        ...(underValue as CSSProperties | undefined),\n        ...(overValue as CSSProperties),\n      };\n    } else if (key === \"ref\") {\n      result[key] =\n        underValue === undefined || underValue === null\n          ? overValue\n          : mergeRefs(underValue as Ref<unknown>, overValue as Ref<unknown>);\n    } else if (isEventHandler(key, overValue) && isEventHandler(key, underValue)) {\n      const [first, second] = overFirst ? [overValue, underValue] : [underValue, overValue];\n      result[key] = (...args: unknown[]) => {\n        first(...args);\n        second(...args);\n      };\n    } else if (isIdReferenceList(key) && typeof underValue === \"string\") {\n      result[key] = overFirst\n        ? mergeTokenLists(overValue, underValue)\n        : mergeTokenLists(underValue, overValue);\n    } else {\n      result[key] = overValue;\n    }\n  }\n\n  return result;\n}\n\n/**\n * Merges the props for a part's element in the order of conventions 1.2: the part's pass-through\n * props, then the `render` element's props, then the library-controlled attributes on top.\n *\n * - The `render` element wins over pass-through props (`aria-label`, `data-*` from the part's own\n *   props, `type`, ...); the library-controlled attributes (`role`, computed `aria-*` state, id\n *   wiring, `data-*` state, the library's handlers) win over the element.\n * - Library-controlled keys are **owned**: a key present in `libraryProps` with an `undefined`\n *   value removes the attribute, whatever the element or the pass-through props say, so a\n *   `render` element can never re-introduce `data-open`, `aria-disabled`, `name`, ... when the\n *   part computes none. A part that does not own a key in some mode omits the key instead. The\n *   function form of `render` is the way to override library attributes deliberately.\n * - `className` is concatenated (part, element), `style` merged with the element winning.\n * - Event handlers all run: the element's first, then the part's pass-through one, then the\n *   library's.\n * - `aria-labelledby` / `aria-describedby` / `aria-controls` / `aria-owns` are merged as token\n *   lists, the element's tokens first.\n * - `ref`s are all attached.\n */\nexport function mergeProps<P extends AnyProps>(\n  partProps: P,\n  elementProps: AnyProps,\n  libraryProps: AnyProps = {},\n): P {\n  // The render element's handlers and tokens come first in both layers.\n  return layer(layer(partProps, elementProps, true, false), libraryProps, false, true) as P;\n}\n"],"mappings":";;;;;AAQA,MAAM,qCAAqB,IAAI,IAAI;CACjC;CACA;CACA;CACA;AACF,CAAC;AAED,SAAS,kBAAkB,KAAsB;CAC/C,OAAO,mBAAmB,IAAI,GAAG;AACnC;AAEA,SAAS,eAAe,KAAa,OAAuD;CAC1F,OAAO,OAAO,UAAU,cAAc,WAAW,KAAK,GAAG;AAC3D;AAEA,SAAS,YAAe,KAA4C;CAClE,OAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,aAAa;AACjE;AAEA,SAAS,UAAa,KAAyB,MAAmC;CAChF,IAAI,QAAQ,QAAQ,QAAQ,KAAA,GAAW,OAAO,KAAA;CAC9C,IAAI,OAAO,QAAQ,YAAY;EAC7B,MAAM,UAAU,IAAI,IAAI;EACxB,OAAO,OAAO,YAAY,aAAa,gBAAgB,IAAI,IAAI;CACjE;CACA,IAAI,YAAe,GAAG,GAAG;EACvB,IAAI,UAAU;EACd,aAAa;GACX,IAAI,UAAU;EAChB;CACF;AAEF;;;;;;AAOA,SAAgB,UAAa,GAAG,MAAuD;CACrF,QAAQ,SAAY;EAClB,MAAM,WAAW,KAAK,KAAK,QAAQ,UAAU,KAAK,IAAI,CAAC;EACvD,aAAa;GACX,KAAK,MAAM,WAAW,UAAU,UAAU;EAC5C;CACF;AACF;;AAGA,SAAgB,gBAAgB,OAAgB,QAAyB;CACvE,MAAM,SAAmB,CAAC;CAC1B,KAAK,MAAM,QAAQ,CAAC,OAAO,MAAM,GAAG;EAClC,IAAI,OAAO,SAAS,UAAU;EAC9B,KAAK,MAAM,SAAS,KAAK,MAAM,KAAK,GAClC,IAAI,UAAU,MAAM,CAAC,OAAO,SAAS,KAAK,GAAG,OAAO,KAAK,KAAK;CAElE;CACA,OAAO,OAAO,KAAK,GAAG;AACxB;;;;;;;;;;;;;AAcA,SAAS,MAAM,OAAiB,MAAgB,WAAoB,OAA0B;CAC5F,MAAM,SAAmB,EAAE,GAAG,MAAM;CAEpC,KAAK,MAAM,OAAO,OAAO,KAAK,IAAI,GAAG;EACnC,MAAM,YAAY,KAAK;EACvB,MAAM,aAAa,MAAM;EAEzB,IAAI,cAAc,KAAA,GAAW;GAG3B,IAAI,OAAO,OAAO,OAAO,KAAA;GACzB;EACF;EAEA,IAAI,QAAQ,aACV,OAAO,OACL,OAAO,eAAe,YAAY,eAAe,KAC7C,GAAG,WAAW,GAAG,OAAO,SAAS,MACjC;OACD,IAAI,QAAQ,SACjB,OAAO,OAAO;GACZ,GAAI;GACJ,GAAI;EACN;OACK,IAAI,QAAQ,OACjB,OAAO,OACL,eAAe,KAAA,KAAa,eAAe,OACvC,YACA,UAAU,YAA4B,SAAyB;OAChE,IAAI,eAAe,KAAK,SAAS,KAAK,eAAe,KAAK,UAAU,GAAG;GAC5E,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,WAAW,UAAU,IAAI,CAAC,YAAY,SAAS;GACpF,OAAO,QAAQ,GAAG,SAAoB;IACpC,MAAM,GAAG,IAAI;IACb,OAAO,GAAG,IAAI;GAChB;EACF,OAAO,IAAI,kBAAkB,GAAG,KAAK,OAAO,eAAe,UACzD,OAAO,OAAO,YACV,gBAAgB,WAAW,UAAU,IACrC,gBAAgB,YAAY,SAAS;OAEzC,OAAO,OAAO;CAElB;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;AAqBA,SAAgB,WACd,WACA,cACA,eAAyB,CAAC,GACvB;CAEH,OAAO,MAAM,MAAM,WAAW,cAAc,MAAM,KAAK,GAAG,cAAc,OAAO,IAAI;AACrF"}