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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 uhyo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,43 @@
-# Temporary Holding Version
+# @funstack/ui
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **Experimental.** APIs will change without notice.
+
+Headless UI library for React — the first **Async React-native** UI library. Part of the
+[FUNSTACK](https://github.com/uhyo/funstack-ui) family.
+
+- **Transition by default.** Interactions are _action props_ (`pressedChangeAction`,
+  `valueChangeAction`, …), run inside a React transition. Actions can be async; components expose
+  `data-pending` and show optimistic state while they run.
+- **Server Functions pass directly.** `<Toggle pressedChangeAction={serverFn} />` works from a
+  Server Component.
+- **Suspense-native.** Content that suspends keeps the previous UI visible instead of flashing a
+  fallback.
+- **`<ViewTransition>` built in** via a `transition` prop.
+- **Modern HTML/CSS first.** Popover API, CSS Anchor Positioning, `<details>`, `hidden="until-found"`;
+  bleeding-edge features behind `experimental_*` props.
+
+Documentation: https://ui.funstack.work
+
+## Installation
+
+```sh
+npm install @funstack/ui@alpha
+```
+
+React 19.3 or later is required (`react` and `react-dom` are peer dependencies).
+
+```tsx
+import { Toggle } from "@funstack/ui/toggle";
+
+<Toggle pressedChangeAction={async (pressed) => await saveFavorite(pressed)}>Favorite</Toggle>;
+```
+
+Components: `Toggle`, `Tabs`, `Accordion`, `Tooltip`.
+
+## Browser support
+
+Latest stable version of each major engine. No fallbacks.
+
+## License
+
+MIT

package/dist/accordion/accordion-context.d.mts

@@ -0,0 +1,5 @@
+//#region src/accordion/accordion-context.d.ts
+/** Why a change was dispatched (design 2.2 / 2.3). */
+export type AccordionChangeReason = "activate" | "platform";
+//#endregion
+//# sourceMappingURL=accordion-context.d.mts.map

package/dist/accordion/accordion-context.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion-context.d.mts","names":[],"sources":["../../src/accordion/accordion-context.ts"],"mappings":";;YAIY"}

package/dist/accordion/accordion-context.mjs

@@ -0,0 +1,9 @@
+"use client";
+import { createContext } from "react";
+//#region src/accordion/accordion-context.ts
+const AccordionRootContext = createContext(null);
+const AccordionItemContext = createContext(null);
+//#endregion
+export { AccordionItemContext, AccordionRootContext };
+
+//# sourceMappingURL=accordion-context.mjs.map

package/dist/accordion/accordion-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion-context.mjs","names":[],"sources":["../../src/accordion/accordion-context.ts"],"sourcesContent":["\"use client\";\nimport { createContext } from \"react\";\n\n/** Why a change was dispatched (design 2.2 / 2.3). */\nexport type AccordionChangeReason = \"activate\" | \"platform\";\n\n/**\n * \"static\": JS-free mode, the browser owns `open`. \"library\": `open` is driven by React\n * committed state inside the Root's transition (design section 2).\n */\nexport type AccordionMode = \"static\" | \"library\";\n\nexport interface AccordionRootContextValue {\n  readonly mode: AccordionMode;\n  readonly exclusive: boolean;\n  /** `name` for every `<details>`; set only in static exclusive mode. */\n  readonly name: string | undefined;\n  readonly disabled: boolean;\n  readonly pending: boolean;\n  /** Committed open set (library mode). Empty in static mode. */\n  readonly committed: ReadonlySet<string>;\n  /** Optimistic open set (library mode). Empty in static mode. */\n  readonly optimistic: ReadonlySet<string>;\n  /** A Trigger was activated: compute `next` from the optimistic set and dispatch. */\n  readonly dispatch: (item: string, open: boolean, event: Event | undefined) => void;\n  /** The browser changed `details.open`: compute `next` from the DOM and dispatch (design 2.3). */\n  readonly dispatchFromDom: (item: string, open: boolean, event: Event | undefined) => void;\n  /** Items register their `<details>` so `dispatchFromDom` can read every item's DOM state. */\n  readonly registerItem: (value: string, element: HTMLDetailsElement) => () => void;\n  /** Triggers register their `<summary>` for arrow-key navigation (design section 5). */\n  readonly registerTrigger: (element: HTMLElement) => () => void;\n}\n\nexport const AccordionRootContext = createContext<AccordionRootContextValue | null>(null);\n\nexport interface AccordionItemContextValue {\n  readonly value: string;\n  readonly disabled: boolean;\n  /** `undefined` in static mode (browser-owned, unknown to React). */\n  readonly committedOpen: boolean | undefined;\n  /** `undefined` in static mode. */\n  readonly optimisticOpen: boolean | undefined;\n  readonly pending: boolean;\n}\n\nexport const AccordionItemContext = createContext<AccordionItemContextValue | null>(null);\n"],"mappings":";;;AAiCA,MAAa,uBAAuB,cAAgD,IAAI;AAYxF,MAAa,uBAAuB,cAAgD,IAAI"}

package/dist/accordion/accordion-item.d.mts

@@ -0,0 +1,53 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode, ViewTransitionClass } from "react";
+//#region src/accordion/accordion-item.d.ts
+export interface AccordionItemState {
+  readonly value: string;
+  /** Optimistic open state. `undefined` in JS-free mode (browser-owned, unknown to React). */
+  readonly open: boolean | undefined;
+  /** This item's open state is changing through an in-flight action. */
+  readonly pending: boolean;
+  /** Disabled by its own prop or by the Root. */
+  readonly disabled: boolean;
+}
+export interface AccordionItemProps extends Omit<ComponentPropsWithRef<"details">, "open" | "name" | "onToggle" | "className" | "style" | "children"> {
+  /** Identifies the item in the Root's `value`. Required in both modes. */
+  value: string;
+  /**
+   * JS-free mode only: renders the initial `open` attribute; the browser owns it from then on.
+   * Ignored (dev warning) in library mode, where the Root's `defaultValue` / `value` decide.
+   */
+  defaultOpen?: boolean;
+  /**
+   * Disables this item: the Trigger renders `aria-disabled` and never toggles. Enforced by a
+   * click handler, so in JS-free mode it does not hold before hydration or with JS off.
+   */
+  disabled?: boolean;
+  /**
+   * Library mode only. Forwarded as `default` to the `<ViewTransition>` around the `<details>`;
+   * animates the commit that ends an action (the `open` attribute flip), not the optimistic
+   * `data-open` flip. Ignored (dev warning) in JS-free mode.
+   *
+   * Static: without `transition` the part renders no `<ViewTransition>`; changing it between
+   * `undefined` and a value remounts the element. Any value, `"none"` included, makes a mount or
+   * `<Activity>` reveal of this part inside a transition start a document view transition: the
+   * page cross-fades for about 250 ms and the next transition commit waits for it (issue #35).
+   */
+  transition?: ViewTransitionClass;
+  className?: StateValue<string | undefined, AccordionItemState>;
+  style?: StateValue<CSSProperties | undefined, AccordionItemState>;
+  children?: StateValue<ReactNode, AccordionItemState>;
+  /** Must render a `<details>` element. */
+  render?: RenderProp<ComponentPropsWithRef<"details">, AccordionItemState>;
+}
+/**
+ * One accordion entry: the `<details>` element. In library mode its `open` attribute follows
+ * committed state and `data-open` / `data-pending` follow optimistic state; in JS-free mode (or
+ * outside any Root, as a standalone disclosure) the browser owns `open`.
+ */
+export declare function AccordionItem({ value, defaultOpen, disabled: disabledProp, transition, className, style, children, render, ...rest }: AccordionItemProps): ReactNode;
+export declare namespace AccordionItem {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=accordion-item.d.mts.map

package/dist/accordion/accordion-item.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion-item.d.mts","names":[],"sources":["../../src/accordion/accordion-item.tsx"],"mappings":";;;iBAiBiB;WACN;;WAEA;;WAEA;;WAEA;;iBAGM,2BAA2B,KAC1C;;EAIA;;;;;EAKA;;;;;EAKA;;;;;;;;;;;EAWA,aAAa;EACb,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;EAC9C,WAAW,WAAW,WAAW;;EAEjC,SAAS,WAAW,kCAAkC;;;;;;;wBAUxC,gBACd,OACA,aACA,UAAU,cACV,YACA,WACA,OACA,UACA,WACG,QACF,qBAAkB;yBAVL"}

package/dist/accordion/accordion-item.mjs

@@ -0,0 +1,85 @@
+"use client";
+import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { useRender } from "../internal/use-render.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { AccordionItemContext, AccordionRootContext } from "./accordion-context.mjs";
+import { use, useCallback, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region src/accordion/accordion-item.tsx
+const isDev = process.env.NODE_ENV !== "production";
+/**
+* One accordion entry: the `<details>` element. In library mode its `open` attribute follows
+* committed state and `data-open` / `data-pending` follow optimistic state; in JS-free mode (or
+* outside any Root, as a standalone disclosure) the browser owns `open`.
+*/
+function AccordionItem({ value, defaultOpen = false, disabled: disabledProp = false, transition, className, style, children, render, ...rest }) {
+	const root = use(AccordionRootContext);
+	const isLibrary = root?.mode === "library";
+	const disabled = disabledProp || (root?.disabled ?? false);
+	const committedOpen = isLibrary ? root.committed.has(value) : void 0;
+	const optimisticOpen = isLibrary ? root.optimistic.has(value) : void 0;
+	const rootPending = root?.pending ?? false;
+	const pending = isLibrary && rootPending && committedOpen !== optimisticOpen;
+	const [staticOpen] = useState(defaultOpen);
+	useDevWarning(isLibrary && defaultOpen, "Accordion.Item: `defaultOpen` is ignored in library mode. Use `defaultValue` or `value` on Accordion.Root instead.");
+	useDevWarning(!isLibrary && transition !== void 0, "Accordion.Item: `transition` has no effect in JS-free mode; the browser toggles the item outside any React transition. Animate `::details-content` with CSS instead.");
+	const registerItem = root?.registerItem;
+	const libraryRef = useCallback((element) => {
+		if (isDev && element.tagName !== "DETAILS") console.error(`Accordion.Item: expected to render a <details> element but got <${element.tagName.toLowerCase()}>. The platform semantics (toggle, find-in-page, exclusive groups) need a real <details>.`);
+		const unregister = registerItem?.(value, element);
+		return () => {
+			unregister?.();
+		};
+	}, [registerItem, value]);
+	const onToggle = isLibrary ? (event) => {
+		const element = event.currentTarget;
+		if (element.open === committedOpen) return;
+		if (disabled) {
+			if (!rootPending) element.open = committedOpen === true;
+			return;
+		}
+		root.dispatchFromDom(value, element.open, event.nativeEvent);
+	} : void 0;
+	const state = {
+		value,
+		open: optimisticOpen,
+		pending,
+		disabled
+	};
+	const itemContext = {
+		value,
+		disabled,
+		committedOpen,
+		optimisticOpen,
+		pending
+	};
+	const element = useRender({
+		defaultElement: "details",
+		render,
+		state,
+		className,
+		style,
+		children,
+		ref: libraryRef,
+		props: rest,
+		libraryProps: {
+			open: isLibrary ? committedOpen : staticOpen,
+			suppressHydrationWarning: true,
+			name: !isLibrary ? root?.name : void 0,
+			...isLibrary && { onToggle },
+			"data-open": dataAttr(optimisticOpen === true),
+			"data-pending": dataAttr(pending),
+			"data-disabled": dataAttr(disabled)
+		}
+	});
+	return useTransitionBoundary("Accordion.Item", isLibrary ? transition : void 0, /* @__PURE__ */ jsx(AccordionItemContext, {
+		value: itemContext,
+		children: element
+	}));
+}
+AccordionItem.displayName = "AccordionItem";
+//#endregion
+export { AccordionItem };
+
+//# sourceMappingURL=accordion-item.mjs.map

package/dist/accordion/accordion-item.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion-item.mjs","names":[],"sources":["../../src/accordion/accordion-item.tsx"],"sourcesContent":["\"use client\";\nimport { use, useCallback, useState } from \"react\";\nimport type {\n  ComponentPropsWithRef,\n  CSSProperties,\n  ReactNode,\n  SyntheticEvent,\n  ViewTransitionClass,\n} from \"react\";\nimport { useTransitionBoundary } from \"../internal/transition-boundary.js\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { useDevWarning } from \"../internal/use-dev-warning.js\";\nimport { useRender } from \"../internal/use-render.js\";\nimport { AccordionItemContext, AccordionRootContext } from \"./accordion-context.js\";\nimport type { AccordionItemContextValue } from \"./accordion-context.js\";\n\nexport interface AccordionItemState {\n  readonly value: string;\n  /** Optimistic open state. `undefined` in JS-free mode (browser-owned, unknown to React). */\n  readonly open: boolean | undefined;\n  /** This item's open state is changing through an in-flight action. */\n  readonly pending: boolean;\n  /** Disabled by its own prop or by the Root. */\n  readonly disabled: boolean;\n}\n\nexport interface AccordionItemProps extends Omit<\n  ComponentPropsWithRef<\"details\">,\n  \"open\" | \"name\" | \"onToggle\" | \"className\" | \"style\" | \"children\"\n> {\n  /** Identifies the item in the Root's `value`. Required in both modes. */\n  value: string;\n  /**\n   * JS-free mode only: renders the initial `open` attribute; the browser owns it from then on.\n   * Ignored (dev warning) in library mode, where the Root's `defaultValue` / `value` decide.\n   */\n  defaultOpen?: boolean;\n  /**\n   * Disables this item: the Trigger renders `aria-disabled` and never toggles. Enforced by a\n   * click handler, so in JS-free mode it does not hold before hydration or with JS off.\n   */\n  disabled?: boolean;\n  /**\n   * Library mode only. Forwarded as `default` to the `<ViewTransition>` around the `<details>`;\n   * animates the commit that ends an action (the `open` attribute flip), not the optimistic\n   * `data-open` flip. Ignored (dev warning) in JS-free mode.\n   *\n   * Static: without `transition` the part renders no `<ViewTransition>`; changing it between\n   * `undefined` and a value remounts the element. Any value, `\"none\"` included, makes a mount or\n   * `<Activity>` reveal of this part inside a transition start a document view transition: the\n   * page cross-fades for about 250 ms and the next transition commit waits for it (issue #35).\n   */\n  transition?: ViewTransitionClass;\n  className?: StateValue<string | undefined, AccordionItemState>;\n  style?: StateValue<CSSProperties | undefined, AccordionItemState>;\n  children?: StateValue<ReactNode, AccordionItemState>;\n  /** Must render a `<details>` element. */\n  render?: RenderProp<ComponentPropsWithRef<\"details\">, AccordionItemState>;\n}\n\nconst isDev = process.env.NODE_ENV !== \"production\";\n\n/**\n * One accordion entry: the `<details>` element. In library mode its `open` attribute follows\n * committed state and `data-open` / `data-pending` follow optimistic state; in JS-free mode (or\n * outside any Root, as a standalone disclosure) the browser owns `open`.\n */\nexport function AccordionItem({\n  value,\n  defaultOpen = false,\n  disabled: disabledProp = false,\n  transition,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: AccordionItemProps) {\n  const root = use(AccordionRootContext);\n  const isLibrary = root?.mode === \"library\";\n  const disabled = disabledProp || (root?.disabled ?? false);\n  const committedOpen = isLibrary ? root.committed.has(value) : undefined;\n  const optimisticOpen = isLibrary ? root.optimistic.has(value) : undefined;\n  const rootPending = root?.pending ?? false;\n  const pending = isLibrary && rootPending && committedOpen !== optimisticOpen;\n  // JS-free mode: the prop React writes never changes after the first render, so React never\n  // rewrites the attribute the browser now owns.\n  const [staticOpen] = useState(defaultOpen);\n\n  useDevWarning(\n    isLibrary && defaultOpen,\n    \"Accordion.Item: `defaultOpen` is ignored in library mode. Use `defaultValue` or `value` on \" +\n      \"Accordion.Root instead.\",\n  );\n  useDevWarning(\n    !isLibrary && transition !== undefined,\n    \"Accordion.Item: `transition` has no effect in JS-free mode; the browser toggles the item \" +\n      \"outside any React transition. Animate `::details-content` with CSS instead.\",\n  );\n\n  const registerItem = root?.registerItem;\n  const libraryRef = useCallback(\n    (element: HTMLDetailsElement) => {\n      if (isDev && element.tagName !== \"DETAILS\") {\n        console.error(\n          `Accordion.Item: expected to render a <details> element but got <${element.tagName.toLowerCase()}>. ` +\n            \"The platform semantics (toggle, find-in-page, exclusive groups) need a real <details>.\",\n        );\n      }\n      const unregister = registerItem?.(value, element);\n      return () => {\n        unregister?.();\n      };\n    },\n    [registerItem, value],\n  );\n\n  // Platform path (design 2.3): the Root reconciles pre-hydration clicks on mount and re-applies\n  // committed state once nothing is in flight; this handler reports the browser's own flips.\n  const onToggle = isLibrary\n    ? (event: SyntheticEvent<HTMLDetailsElement>) => {\n        const element = event.currentTarget;\n        // Read `details.open`, never `ToggleEvent.newState`: `toggle` is coalesced.\n        if (element.open === committedOpen) return; // our own commit echoing back\n        if (disabled) {\n          // A disabled item cannot be opened by the browser either; close it again now or, while\n          // an action is in flight, when the Root re-applies committed state.\n          if (!rootPending) element.open = committedOpen === true;\n          return;\n        }\n        root.dispatchFromDom(value, element.open, event.nativeEvent);\n      }\n    : undefined;\n\n  const state: AccordionItemState = { value, open: optimisticOpen, pending, disabled };\n  const itemContext: AccordionItemContextValue = {\n    value,\n    disabled,\n    committedOpen,\n    optimisticOpen,\n    pending,\n  };\n\n  const element = useRender<ComponentPropsWithRef<\"details\">, AccordionItemState>({\n    defaultElement: \"details\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    ref: libraryRef,\n    props: rest,\n    // Library-controlled layer: `open`, `name` and `onToggle` are owned by the library in at\n    // least one mode, so a `render` element cannot override them either (conventions 1.2).\n    libraryProps: {\n      open: isLibrary ? committedOpen : staticOpen,\n      // A click before hydration changes `open` under React's feet in both modes; the mismatch is\n      // expected and reconciled (library mode) or the browser's business (JS-free mode).\n      suppressHydrationWarning: true,\n      // Owned in both modes: in library mode there is one writer of `open`, so a render element's\n      // `name` (a second, platform-level writer) is removed.\n      name: !isLibrary ? root?.name : undefined,\n      // Only installed in library mode; owning the key in static mode would strip a render\n      // element's own `onToggle`.\n      ...(isLibrary && { onToggle }),\n      \"data-open\": dataAttr(optimisticOpen === true),\n      \"data-pending\": dataAttr(pending),\n      \"data-disabled\": dataAttr(disabled),\n    },\n  });\n\n  return useTransitionBoundary(\n    \"Accordion.Item\",\n    isLibrary ? transition : undefined,\n    <AccordionItemContext value={itemContext}>{element}</AccordionItemContext>,\n  );\n}\n\nAccordionItem.displayName = \"AccordionItem\";\n"],"mappings":";;;;;;;;;AA6DA,MAAM,QAAQ,QAAQ,IAAI,aAAa;;;;;;AAOvC,SAAgB,cAAc,EAC5B,OACA,cAAc,OACd,UAAU,eAAe,OACzB,YACA,WACA,OACA,UACA,QACA,GAAG,QACkB;CACrB,MAAM,OAAO,IAAI,oBAAoB;CACrC,MAAM,YAAY,MAAM,SAAS;CACjC,MAAM,WAAW,iBAAiB,MAAM,YAAY;CACpD,MAAM,gBAAgB,YAAY,KAAK,UAAU,IAAI,KAAK,IAAI,KAAA;CAC9D,MAAM,iBAAiB,YAAY,KAAK,WAAW,IAAI,KAAK,IAAI,KAAA;CAChE,MAAM,cAAc,MAAM,WAAW;CACrC,MAAM,UAAU,aAAa,eAAe,kBAAkB;CAG9D,MAAM,CAAC,cAAc,SAAS,WAAW;CAEzC,cACE,aAAa,aACb,oHAEF;CACA,cACE,CAAC,aAAa,eAAe,KAAA,GAC7B,sKAEF;CAEA,MAAM,eAAe,MAAM;CAC3B,MAAM,aAAa,aAChB,YAAgC;EAC/B,IAAI,SAAS,QAAQ,YAAY,WAC/B,QAAQ,MACN,mEAAmE,QAAQ,QAAQ,YAAY,EAAE,0FAEnG;EAEF,MAAM,aAAa,eAAe,OAAO,OAAO;EAChD,aAAa;GACX,aAAa;EACf;CACF,GACA,CAAC,cAAc,KAAK,CACtB;CAIA,MAAM,WAAW,aACZ,UAA8C;EAC7C,MAAM,UAAU,MAAM;EAEtB,IAAI,QAAQ,SAAS,eAAe;EACpC,IAAI,UAAU;GAGZ,IAAI,CAAC,aAAa,QAAQ,OAAO,kBAAkB;GACnD;EACF;EACA,KAAK,gBAAgB,OAAO,QAAQ,MAAM,MAAM,WAAW;CAC7D,IACA,KAAA;CAEJ,MAAM,QAA4B;EAAE;EAAO,MAAM;EAAgB;EAAS;CAAS;CACnF,MAAM,cAAyC;EAC7C;EACA;EACA;EACA;EACA;CACF;CAEA,MAAM,UAAU,UAAgE;EAC9E,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA,KAAK;EACL,OAAO;EAGP,cAAc;GACZ,MAAM,YAAY,gBAAgB;GAGlC,0BAA0B;GAG1B,MAAM,CAAC,YAAY,MAAM,OAAO,KAAA;GAGhC,GAAI,aAAa,EAAE,SAAS;GAC5B,aAAa,SAAS,mBAAmB,IAAI;GAC7C,gBAAgB,SAAS,OAAO;GAChC,iBAAiB,SAAS,QAAQ;EACpC;CACF,CAAC;CAED,OAAO,sBACL,kBACA,YAAY,aAAa,KAAA,GACzB,oBAAC,sBAAD;EAAsB,OAAO;EAAc,UAAA;CAA8B,CAAA,CAC3E;AACF;AAEA,cAAc,cAAc"}

package/dist/accordion/accordion-panel.d.mts

@@ -0,0 +1,40 @@
+import { RenderProp, StateValue } from "../internal/types.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode, ViewTransitionClass } from "react";
+//#region src/accordion/accordion-panel.d.ts
+export interface AccordionPanelState {
+  readonly value: string;
+  /** Committed open state. `undefined` in JS-free mode. */
+  readonly open: boolean | undefined;
+  readonly disabled: boolean;
+}
+export interface AccordionPanelProps extends Omit<ComponentPropsWithRef<"div">, "className" | "style" | "children"> {
+  /**
+   * Library mode only. Forwarded as `default` to the `<ViewTransition>` around the panel's
+   * `div`; animates content that mounts or changes in the commit that ends an action.
+   *
+   * Static: without `transition` the part renders no `<ViewTransition>`; changing it between
+   * `undefined` and a value remounts the element. Any value, `"none"` included, makes a mount or
+   * `<Activity>` reveal of this part inside a transition start a document view transition: the
+   * page cross-fades for about 250 ms and the next transition commit waits for it (issue #35).
+   */
+  transition?: ViewTransitionClass;
+  className?: StateValue<string | undefined, AccordionPanelState>;
+  style?: StateValue<CSSProperties | undefined, AccordionPanelState>;
+  /**
+   * Always mounted (closed `<details>` content stays in the DOM, indexable and searchable). The
+   * function form receives committed `open`, which is how content is mounted lazily and how
+   * suspending content keeps the item closed until it is ready.
+   */
+  children?: StateValue<ReactNode, AccordionPanelState>;
+  render?: RenderProp<ComponentPropsWithRef<"div">, AccordionPanelState>;
+}
+/**
+ * The item's content region: a `div` inside the `<details>`, after the Trigger. Its visibility
+ * is the parent's `open` attribute (`details:open > .panel`); it renders committed state.
+ */
+export declare function AccordionPanel({ transition, className, style, children, render, ...rest }: AccordionPanelProps): ReactNode;
+export declare namespace AccordionPanel {
+  var displayName: string;
+}
+//#endregion
+//# sourceMappingURL=accordion-panel.d.mts.map

package/dist/accordion/accordion-panel.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion-panel.d.mts","names":[],"sources":["../../src/accordion/accordion-panel.tsx"],"mappings":";;;iBAUiB;WACN;;WAEA;WACA;;iBAGM,4BAA4B,KAC3C;;;;;;;;;;EAYA,aAAa;EACb,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;;;;;;EAM9C,WAAW,WAAW,WAAW;EACjC,SAAS,WAAW,8BAA8B;;;;;;wBAOpC,iBACd,YACA,WACA,OACA,UACA,WACG,QACF,sBAAmB;yBAPN"}

package/dist/accordion/accordion-panel.mjs

@@ -0,0 +1,40 @@
+"use client";
+import { useTransitionBoundary } from "../internal/transition-boundary.mjs";
+import { dataAttr } from "../internal/data-attr.mjs";
+import { useRender } from "../internal/use-render.mjs";
+import { useDevWarning } from "../internal/use-dev-warning.mjs";
+import { AccordionItemContext, AccordionRootContext } from "./accordion-context.mjs";
+import { use } from "react";
+//#region src/accordion/accordion-panel.tsx
+/**
+* The item's content region: a `div` inside the `<details>`, after the Trigger. Its visibility
+* is the parent's `open` attribute (`details:open > .panel`); it renders committed state.
+*/
+function AccordionPanel({ transition, className, style, children, render, ...rest }) {
+	const root = use(AccordionRootContext);
+	const item = use(AccordionItemContext);
+	if (item === null) throw new Error("Accordion.Panel must be rendered inside an Accordion.Item.");
+	const isLibrary = root?.mode === "library";
+	useDevWarning(!isLibrary && transition !== void 0, "Accordion.Panel: `transition` has no effect in JS-free mode; the browser toggles the item outside any React transition.");
+	const state = {
+		value: item.value,
+		open: item.committedOpen,
+		disabled: item.disabled
+	};
+	const element = useRender({
+		defaultElement: "div",
+		render,
+		state,
+		className,
+		style,
+		children,
+		props: rest,
+		libraryProps: { "data-disabled": dataAttr(item.disabled) }
+	});
+	return useTransitionBoundary("Accordion.Panel", isLibrary ? transition : void 0, element);
+}
+AccordionPanel.displayName = "AccordionPanel";
+//#endregion
+export { AccordionPanel };
+
+//# sourceMappingURL=accordion-panel.mjs.map

package/dist/accordion/accordion-panel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion-panel.mjs","names":[],"sources":["../../src/accordion/accordion-panel.tsx"],"sourcesContent":["\"use client\";\nimport { use } from \"react\";\nimport type { ComponentPropsWithRef, CSSProperties, ReactNode, ViewTransitionClass } from \"react\";\nimport { useTransitionBoundary } from \"../internal/transition-boundary.js\";\nimport { dataAttr } from \"../internal/data-attr.js\";\nimport type { RenderProp, StateValue } from \"../internal/types.js\";\nimport { useDevWarning } from \"../internal/use-dev-warning.js\";\nimport { useRender } from \"../internal/use-render.js\";\nimport { AccordionItemContext, AccordionRootContext } from \"./accordion-context.js\";\n\nexport interface AccordionPanelState {\n  readonly value: string;\n  /** Committed open state. `undefined` in JS-free mode. */\n  readonly open: boolean | undefined;\n  readonly disabled: boolean;\n}\n\nexport interface AccordionPanelProps extends Omit<\n  ComponentPropsWithRef<\"div\">,\n  \"className\" | \"style\" | \"children\"\n> {\n  /**\n   * Library mode only. Forwarded as `default` to the `<ViewTransition>` around the panel's\n   * `div`; animates content that mounts or changes in the commit that ends an action.\n   *\n   * Static: without `transition` the part renders no `<ViewTransition>`; changing it between\n   * `undefined` and a value remounts the element. Any value, `\"none\"` included, makes a mount or\n   * `<Activity>` reveal of this part inside a transition start a document view transition: the\n   * page cross-fades for about 250 ms and the next transition commit waits for it (issue #35).\n   */\n  transition?: ViewTransitionClass;\n  className?: StateValue<string | undefined, AccordionPanelState>;\n  style?: StateValue<CSSProperties | undefined, AccordionPanelState>;\n  /**\n   * Always mounted (closed `<details>` content stays in the DOM, indexable and searchable). The\n   * function form receives committed `open`, which is how content is mounted lazily and how\n   * suspending content keeps the item closed until it is ready.\n   */\n  children?: StateValue<ReactNode, AccordionPanelState>;\n  render?: RenderProp<ComponentPropsWithRef<\"div\">, AccordionPanelState>;\n}\n\n/**\n * The item's content region: a `div` inside the `<details>`, after the Trigger. Its visibility\n * is the parent's `open` attribute (`details:open > .panel`); it renders committed state.\n */\nexport function AccordionPanel({\n  transition,\n  className,\n  style,\n  children,\n  render,\n  ...rest\n}: AccordionPanelProps) {\n  const root = use(AccordionRootContext);\n  const item = use(AccordionItemContext);\n  if (item === null) {\n    throw new Error(\"Accordion.Panel must be rendered inside an Accordion.Item.\");\n  }\n  const isLibrary = root?.mode === \"library\";\n\n  useDevWarning(\n    !isLibrary && transition !== undefined,\n    \"Accordion.Panel: `transition` has no effect in JS-free mode; the browser toggles the item \" +\n      \"outside any React transition.\",\n  );\n\n  const state: AccordionPanelState = {\n    value: item.value,\n    open: item.committedOpen,\n    disabled: item.disabled,\n  };\n\n  const element = useRender<ComponentPropsWithRef<\"div\">, AccordionPanelState>({\n    defaultElement: \"div\",\n    render,\n    state,\n    className,\n    style,\n    children,\n    props: rest,\n    libraryProps: {\n      \"data-disabled\": dataAttr(item.disabled),\n    },\n  });\n\n  return useTransitionBoundary(\"Accordion.Panel\", isLibrary ? transition : undefined, element);\n}\n\nAccordionPanel.displayName = \"AccordionPanel\";\n"],"mappings":";;;;;;;;;;;;AA8CA,SAAgB,eAAe,EAC7B,YACA,WACA,OACA,UACA,QACA,GAAG,QACmB;CACtB,MAAM,OAAO,IAAI,oBAAoB;CACrC,MAAM,OAAO,IAAI,oBAAoB;CACrC,IAAI,SAAS,MACX,MAAM,IAAI,MAAM,4DAA4D;CAE9E,MAAM,YAAY,MAAM,SAAS;CAEjC,cACE,CAAC,aAAa,eAAe,KAAA,GAC7B,yHAEF;CAEA,MAAM,QAA6B;EACjC,OAAO,KAAK;EACZ,MAAM,KAAK;EACX,UAAU,KAAK;CACjB;CAEA,MAAM,UAAU,UAA6D;EAC3E,gBAAgB;EAChB;EACA;EACA;EACA;EACA;EACA,OAAO;EACP,cAAc,EACZ,iBAAiB,SAAS,KAAK,QAAQ,EACzC;CACF,CAAC;CAED,OAAO,sBAAsB,mBAAmB,YAAY,aAAa,KAAA,GAAW,OAAO;AAC7F;AAEA,eAAe,cAAc"}

package/dist/accordion/accordion-root.d.mts

@@ -0,0 +1,90 @@
+import { ActionDetails, ChangeAction, RenderProp, StateValue } from "../internal/types.mjs";
+import { AccordionChangeReason } from "./accordion-context.mjs";
+import { CSSProperties, ComponentPropsWithRef, ReactNode } from "react";
+//#region src/accordion/accordion-root.d.ts
+export interface AccordionRootState {
+  /** An action dispatched through this Accordion is in flight (library mode only). */
+  readonly pending: boolean;
+  /** The Root's `disabled` prop. */
+  readonly disabled: boolean;
+}
+/** Details passed as the second argument of `valueChangeAction`. */
+export interface AccordionValueChangeDetails extends ActionDetails {
+  /**
+   * `"activate"`: the user activated a Trigger. `"platform"`: the browser changed `open` itself
+   * (find-in-page, a text fragment, a click before hydration); `event` is then the `toggle`
+   * event, or `undefined` when the mismatch was found on mount.
+   */
+  readonly reason: AccordionChangeReason;
+  /** The item whose open state changed. */
+  readonly item: string;
+  /** That item's new open state. */
+  readonly open: boolean;
+}
+interface AccordionRootBaseProps extends Omit<ComponentPropsWithRef<"div">, "onKeyDown" | "defaultValue" | "className" | "style" | "children"> {
+  /** Disables every item: triggers render `aria-disabled` and never dispatch. Default `false`. */
+  disabled?: boolean;
+  /**
+   * Renders `interpolate-size: allow-keywords` on the root so `::details-content` can transition
+   * `height` to `auto`. Chromium-only polish today; use the `grid-template-rows` form for a
+   * cross-engine animation. Merged with `style`; the consumer's declaration wins.
+   */
+  experimental_interpolateSize?: boolean;
+  className?: StateValue<string | undefined, AccordionRootState>;
+  style?: StateValue<CSSProperties | undefined, AccordionRootState>;
+  children?: StateValue<ReactNode, AccordionRootState>;
+  render?: RenderProp<ComponentPropsWithRef<"div">, AccordionRootState>;
+}
+export interface AccordionRootMultipleProps extends AccordionRootBaseProps {
+  /** Any number of items may be open. */
+  exclusive?: false;
+  /** Controlled open items. `undefined` means uncontrolled; `[]` means none open. */
+  value?: string[];
+  /** Initial open items in uncontrolled library mode. */
+  defaultValue?: string[];
+  /**
+   * Called with the next open items on every change. Runs inside the Root's transition; may be
+   * sync or async (also a Server Function). Rejections reach the nearest Error Boundary.
+   *
+   * May also be called with `details.reason === "platform"` when the browser opened an item
+   * itself (find-in-page, a click before hydration); committed state is re-applied to the DOM
+   * once the action settles.
+   *
+   * A `setState` placed after your own `await` is not a Transition update; wrap it in
+   * `startTransition` (React limitation).
+   */
+  valueChangeAction?: ChangeAction<string[], AccordionValueChangeDetails>;
+}
+export interface AccordionRootExclusiveProps extends AccordionRootBaseProps {
+  /**
+   * At most one item open. JS-free mode: renders the same `name` on every `<details>` (the
+   * platform's exclusive group). Library mode: the value is a single item or `null`.
+   */
+  exclusive: true;
+  /** Controlled open item. `undefined` means uncontrolled; `null` means none open. */
+  value?: string | null;
+  /** Initial open item in uncontrolled library mode. */
+  defaultValue?: string | null;
+  /** See {@link AccordionRootMultipleProps.valueChangeAction}. */
+  valueChangeAction?: ChangeAction<string | null, AccordionValueChangeDetails>;
+}
+/**
+ * Props of `Accordion.Root`, discriminated on `exclusive`.
+ *
+ * Without `value`, `defaultValue` and `valueChangeAction` the Accordion runs in **JS-free mode**:
+ * the browser owns each `<details open>`, nothing runs on toggle, and `exclusive` renders `name`.
+ * With any of them it runs in **library mode**: the summary click is intercepted, `open` is driven
+ * by committed state inside a transition, and triggers show optimistic `data-open`.
+ */
+export type AccordionRootProps = AccordionRootMultipleProps | AccordionRootExclusiveProps;
+/**
+ * The accordion container: a `div` that owns the open state, the transition, the context the
+ * other parts read, and ArrowUp/ArrowDown/Home/End navigation between triggers.
+ */
+export declare function AccordionRoot(props: AccordionRootProps): import("react").JSX.Element;
+export declare namespace AccordionRoot {
+  var displayName: string;
+}
+//#endregion
+export {};
+//# sourceMappingURL=accordion-root.d.mts.map

package/dist/accordion/accordion-root.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accordion-root.d.mts","names":[],"sources":["../../src/accordion/accordion-root.tsx"],"mappings":";;;;iBAyBiB;;WAEN;;WAEA;;;iBAIM,oCAAoC;;;;;;WAM1C,QAAQ;;WAER;;WAEA;;UAGD,+BAA+B,KACvC;;EAKA;;;;;;EAMA;EACA,YAAY,+BAA+B;EAC3C,QAAQ,WAAW,2BAA2B;EAC9C,WAAW,WAAW,WAAW;EACjC,SAAS,WAAW,8BAA8B;;iBAGnC,mCAAmC;;EAElD;;EAEA;;EAEA;;;;;;;;;;;;EAYA,oBAAoB,uBAAuB;;iBAG5B,oCAAoC;;;;;EAKnD;;EAEA;;EAEA;;EAEA,oBAAoB,4BAA4B;;;;;;;;;;YAWtC,qBAAqB,6BAA6B;;;;;wBAqF9C,cAAc,OAAO,qCAAkB,IAAA;yBAAvC"}