@react-aria/disclosure 3.0.0-alpha.0

package/README.md

@@ -0,0 +1,3 @@
+# @react-aria/disclosure
+
+This package is part of [react-spectrum](https://github.com/adobe/react-spectrum). See the repo for more details.

package/dist/import.mjs

@@ -0,0 +1,17 @@
+import {useDisclosure as $5e910fae8e128ead$export$6e3e27031a30522f} from "./useDisclosure.mjs";
+
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+export {$5e910fae8e128ead$export$6e3e27031a30522f as useDisclosure};
+//# sourceMappingURL=module.js.map

package/dist/main.js

@@ -0,0 +1,22 @@
+var $ef53cd1bcef2de68$exports = require("./useDisclosure.main.js");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "useDisclosure", () => $ef53cd1bcef2de68$exports.useDisclosure);
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;AAAA;;;;;;;;;;CAUC","sources":["packages/@react-aria/disclosure/src/index.ts"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n * \n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nexport {useDisclosure} from './useDisclosure';\nexport type {DisclosureAria, AriaDisclosureProps} from './useDisclosure';\n"],"names":[],"version":3,"file":"main.js.map"}

package/dist/module.js

@@ -0,0 +1,17 @@
+import {useDisclosure as $5e910fae8e128ead$export$6e3e27031a30522f} from "./useDisclosure.module.js";
+
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+export {$5e910fae8e128ead$export$6e3e27031a30522f as useDisclosure};
+//# sourceMappingURL=module.js.map

package/dist/module.js.map

@@ -0,0 +1 @@
+{"mappings":";;AAAA;;;;;;;;;;CAUC","sources":["packages/@react-aria/disclosure/src/index.ts"],"sourcesContent":["/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n * \n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nexport {useDisclosure} from './useDisclosure';\nexport type {DisclosureAria, AriaDisclosureProps} from './useDisclosure';\n"],"names":[],"version":3,"file":"module.js.map"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+import { AriaButtonProps } from "@react-types/button";
+import { DisclosureState } from "@react-stately/disclosure";
+import { HTMLAttributes, RefObject } from "react";
+export interface AriaDisclosureProps {
+    /** Whether the disclosure is disabled. */
+    isDisabled?: boolean;
+    /** Handler that is called when the disclosure's expanded state changes. */
+    onExpandedChange?: (isExpanded: boolean) => void;
+    /** Whether the disclosure is expanded (controlled). */
+    isExpanded?: boolean;
+    /** Whether the disclosure is expanded by default (uncontrolled). */
+    defaultExpanded?: boolean;
+}
+export interface DisclosureAria {
+    /** Props for the disclosure button. */
+    buttonProps: AriaButtonProps;
+    /** Props for the disclosure panel. */
+    panelProps: HTMLAttributes<HTMLElement>;
+}
+/**
+ * Provides the behavior and accessibility implementation for a disclosure component.
+ * @param props - Props for the disclosure.
+ * @param state - State for the disclosure, as returned by `useDisclosureState`.
+ * @param ref - A ref for the disclosure content.
+ */
+export function useDisclosure(props: AriaDisclosureProps, state: DisclosureState, ref?: RefObject<Element | null>): DisclosureAria;
+
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"mappings":";;;AAkBA;IACE,0CAA0C;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,uDAAuD;IACvD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED;IACE,uCAAuC;IACvC,WAAW,EAAE,eAAe,CAAC;IAC7B,sCAAsC;IACtC,UAAU,EAAE,eAAe,WAAW,CAAC,CAAA;CACxC;AAED;;;;;GAKG;AACH,8BAA8B,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,CAAC,EAAE,UAAU,OAAO,GAAG,IAAI,CAAC,GAAG,cAAc,CAkDjI","sources":["packages/@react-aria/disclosure/src/packages/@react-aria/disclosure/src/useDisclosure.ts","packages/@react-aria/disclosure/src/packages/@react-aria/disclosure/src/index.ts","packages/@react-aria/disclosure/src/index.ts"],"sourcesContent":[null,null,"/*\n * Copyright 2020 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n * \n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\nexport {useDisclosure} from './useDisclosure';\nexport type {DisclosureAria, AriaDisclosureProps} from './useDisclosure';\n"],"names":[],"version":3,"file":"types.d.ts.map"}

package/dist/useDisclosure.main.js

@@ -0,0 +1,74 @@
+var $l3cx6$react = require("react");
+var $l3cx6$reactariautils = require("@react-aria/utils");
+var $l3cx6$reactariassr = require("@react-aria/ssr");
+
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "useDisclosure", () => $ef53cd1bcef2de68$export$6e3e27031a30522f);
+/*
+ * Copyright 2024 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+function $ef53cd1bcef2de68$export$6e3e27031a30522f(props, state, ref) {
+    let { isDisabled: isDisabled } = props;
+    let triggerId = (0, $l3cx6$reactariautils.useId)();
+    let contentId = (0, $l3cx6$reactariautils.useId)();
+    let isControlled = props.isExpanded !== undefined;
+    let isSSR = (0, $l3cx6$reactariassr.useIsSSR)();
+    let supportsBeforeMatch = !isSSR && 'onbeforematch' in document.body;
+    // @ts-ignore https://github.com/facebook/react/pull/24741
+    (0, $l3cx6$reactariautils.useEvent)(ref, 'beforematch', supportsBeforeMatch && !isControlled ? ()=>state.expand() : null);
+    (0, $l3cx6$react.useEffect)(()=>{
+        // Until React supports hidden="until-found": https://github.com/facebook/react/pull/24741
+        if (supportsBeforeMatch && (ref === null || ref === void 0 ? void 0 : ref.current) && !isControlled && !isDisabled) {
+            if (state.isExpanded) ref.current.removeAttribute('hidden');
+            else ref.current.setAttribute('hidden', 'until-found');
+        }
+    }, [
+        isControlled,
+        ref,
+        props.isExpanded,
+        state,
+        supportsBeforeMatch,
+        isDisabled
+    ]);
+    return {
+        buttonProps: {
+            id: triggerId,
+            'aria-expanded': state.isExpanded,
+            'aria-controls': contentId,
+            onPress: (e)=>{
+                if (!isDisabled && e.pointerType !== 'keyboard') state.toggle();
+            },
+            isDisabled: isDisabled,
+            onKeyDown (e) {
+                if (!isDisabled && (e.key === 'Enter' || e.key === ' ')) {
+                    e.preventDefault();
+                    state.toggle();
+                }
+            }
+        },
+        panelProps: {
+            id: contentId,
+            // This can be overridden at the panel element level.
+            role: 'group',
+            'aria-labelledby': triggerId,
+            hidden: !supportsBeforeMatch || isControlled ? !state.isExpanded : true
+        }
+    };
+}
+
+
+//# sourceMappingURL=useDisclosure.main.js.map

package/dist/useDisclosure.main.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;;;;;;;AAAA;;;;;;;;;;CAUC;;;AAgCM,SAAS,0CAAc,KAA0B,EAAE,KAAsB,EAAE,GAA+B;IAC/G,IAAI,cACF,UAAU,EACX,GAAG;IACJ,IAAI,YAAY,CAAA,GAAA,2BAAI;IACpB,IAAI,YAAY,CAAA,GAAA,2BAAI;IACpB,IAAI,eAAe,MAAM,UAAU,KAAK;IACxC,IAAI,QAAQ,CAAA,GAAA,4BAAO;IACnB,IAAI,sBAAsB,CAAC,SAAS,mBAAmB,SAAS,IAAI;IAEpE,0DAA0D;IAC1D,CAAA,GAAA,8BAAO,EAAE,KAAK,eAAe,uBAAuB,CAAC,eAAe,IAAM,MAAM,MAAM,KAAK;IAE3F,CAAA,GAAA,sBAAQ,EAAE;QACR,0FAA0F;QAC1F,IAAI,wBAAuB,gBAAA,0BAAA,IAAK,OAAO,KAAI,CAAC,gBAAgB,CAAC;YAC3D,IAAI,MAAM,UAAU,EAClB,IAAI,OAAO,CAAC,eAAe,CAAC;iBAE5B,IAAI,OAAO,CAAC,YAAY,CAAC,UAAU;;IAGzC,GAAG;QAAC;QAAc;QAAK,MAAM,UAAU;QAAE;QAAO;QAAqB;KAAW;IAEhF,OAAO;QACL,aAAa;YACX,IAAI;YACJ,iBAAiB,MAAM,UAAU;YACjC,iBAAiB;YACjB,SAAS,CAAC;gBACR,IAAI,CAAC,cAAc,EAAE,WAAW,KAAK,YACnC,MAAM,MAAM;YAEhB;wBACA;YACA,WAAU,CAAC;gBACT,IAAI,CAAC,cAAe,CAAA,EAAE,GAAG,KAAK,WAAW,EAAE,GAAG,KAAK,GAAE,GAAI;oBACvD,EAAE,cAAc;oBAChB,MAAM,MAAM;gBACd;YACF;QACF;QACA,YAAY;YACV,IAAI;YACJ,qDAAqD;YACrD,MAAM;YACN,mBAAmB;YACnB,QAAQ,AAAC,CAAC,uBAAuB,eAAgB,CAAC,MAAM,UAAU,GAAG;QACvE;IACF;AACF","sources":["packages/@react-aria/disclosure/src/useDisclosure.ts"],"sourcesContent":["/*\n * Copyright 2024 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the 'License');\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {AriaButtonProps} from '@react-types/button';\nimport {DisclosureState} from '@react-stately/disclosure';\nimport {HTMLAttributes, RefObject, useEffect} from 'react';\nimport {useEvent, useId} from '@react-aria/utils';\nimport {useIsSSR} from '@react-aria/ssr';\n\nexport interface AriaDisclosureProps {\n  /** Whether the disclosure is disabled. */\n  isDisabled?: boolean,\n  /** Handler that is called when the disclosure's expanded state changes. */\n  onExpandedChange?: (isExpanded: boolean) => void,\n  /** Whether the disclosure is expanded (controlled). */\n  isExpanded?: boolean,\n  /** Whether the disclosure is expanded by default (uncontrolled). */\n  defaultExpanded?: boolean\n}\n\nexport interface DisclosureAria {\n  /** Props for the disclosure button. */\n  buttonProps: AriaButtonProps,\n  /** Props for the disclosure panel. */\n  panelProps: HTMLAttributes<HTMLElement>\n}\n\n/**\n * Provides the behavior and accessibility implementation for a disclosure component.\n * @param props - Props for the disclosure.\n * @param state - State for the disclosure, as returned by `useDisclosureState`.\n * @param ref - A ref for the disclosure content.\n */\nexport function useDisclosure(props: AriaDisclosureProps, state: DisclosureState, ref?: RefObject<Element | null>): DisclosureAria {\n  let {\n    isDisabled\n  } = props;\n  let triggerId = useId();\n  let contentId = useId();\n  let isControlled = props.isExpanded !== undefined;\n  let isSSR = useIsSSR();\n  let supportsBeforeMatch = !isSSR && 'onbeforematch' in document.body;\n\n  // @ts-ignore https://github.com/facebook/react/pull/24741\n  useEvent(ref, 'beforematch', supportsBeforeMatch && !isControlled ? () => state.expand() : null);\n\n  useEffect(() => {\n    // Until React supports hidden=\"until-found\": https://github.com/facebook/react/pull/24741\n    if (supportsBeforeMatch && ref?.current && !isControlled && !isDisabled) {\n      if (state.isExpanded) {\n        ref.current.removeAttribute('hidden');\n      } else {\n        ref.current.setAttribute('hidden', 'until-found');\n      }\n    }\n  }, [isControlled, ref, props.isExpanded, state, supportsBeforeMatch, isDisabled]);\n\n  return {\n    buttonProps: {\n      id: triggerId,\n      'aria-expanded': state.isExpanded,\n      'aria-controls': contentId,\n      onPress: (e) => {\n        if (!isDisabled && e.pointerType !== 'keyboard') {\n          state.toggle();\n        }\n      },\n      isDisabled,\n      onKeyDown(e) {\n        if (!isDisabled && (e.key === 'Enter' || e.key === ' ')) {\n          e.preventDefault();\n          state.toggle();\n        }\n      }\n    },\n    panelProps: {\n      id: contentId,\n      // This can be overridden at the panel element level.\n      role: 'group',\n      'aria-labelledby': triggerId,\n      hidden: (!supportsBeforeMatch || isControlled) ? !state.isExpanded : true\n    }\n  };\n}\n"],"names":[],"version":3,"file":"useDisclosure.main.js.map"}

package/dist/useDisclosure.mjs

@@ -0,0 +1,69 @@
+import {useEffect as $6wN6e$useEffect} from "react";
+import {useId as $6wN6e$useId, useEvent as $6wN6e$useEvent} from "@react-aria/utils";
+import {useIsSSR as $6wN6e$useIsSSR} from "@react-aria/ssr";
+
+/*
+ * Copyright 2024 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+function $5e910fae8e128ead$export$6e3e27031a30522f(props, state, ref) {
+    let { isDisabled: isDisabled } = props;
+    let triggerId = (0, $6wN6e$useId)();
+    let contentId = (0, $6wN6e$useId)();
+    let isControlled = props.isExpanded !== undefined;
+    let isSSR = (0, $6wN6e$useIsSSR)();
+    let supportsBeforeMatch = !isSSR && 'onbeforematch' in document.body;
+    // @ts-ignore https://github.com/facebook/react/pull/24741
+    (0, $6wN6e$useEvent)(ref, 'beforematch', supportsBeforeMatch && !isControlled ? ()=>state.expand() : null);
+    (0, $6wN6e$useEffect)(()=>{
+        // Until React supports hidden="until-found": https://github.com/facebook/react/pull/24741
+        if (supportsBeforeMatch && (ref === null || ref === void 0 ? void 0 : ref.current) && !isControlled && !isDisabled) {
+            if (state.isExpanded) ref.current.removeAttribute('hidden');
+            else ref.current.setAttribute('hidden', 'until-found');
+        }
+    }, [
+        isControlled,
+        ref,
+        props.isExpanded,
+        state,
+        supportsBeforeMatch,
+        isDisabled
+    ]);
+    return {
+        buttonProps: {
+            id: triggerId,
+            'aria-expanded': state.isExpanded,
+            'aria-controls': contentId,
+            onPress: (e)=>{
+                if (!isDisabled && e.pointerType !== 'keyboard') state.toggle();
+            },
+            isDisabled: isDisabled,
+            onKeyDown (e) {
+                if (!isDisabled && (e.key === 'Enter' || e.key === ' ')) {
+                    e.preventDefault();
+                    state.toggle();
+                }
+            }
+        },
+        panelProps: {
+            id: contentId,
+            // This can be overridden at the panel element level.
+            role: 'group',
+            'aria-labelledby': triggerId,
+            hidden: !supportsBeforeMatch || isControlled ? !state.isExpanded : true
+        }
+    };
+}
+
+
+export {$5e910fae8e128ead$export$6e3e27031a30522f as useDisclosure};
+//# sourceMappingURL=useDisclosure.module.js.map

package/dist/useDisclosure.module.js

@@ -0,0 +1,69 @@
+import {useEffect as $6wN6e$useEffect} from "react";
+import {useId as $6wN6e$useId, useEvent as $6wN6e$useEvent} from "@react-aria/utils";
+import {useIsSSR as $6wN6e$useIsSSR} from "@react-aria/ssr";
+
+/*
+ * Copyright 2024 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */ 
+
+
+function $5e910fae8e128ead$export$6e3e27031a30522f(props, state, ref) {
+    let { isDisabled: isDisabled } = props;
+    let triggerId = (0, $6wN6e$useId)();
+    let contentId = (0, $6wN6e$useId)();
+    let isControlled = props.isExpanded !== undefined;
+    let isSSR = (0, $6wN6e$useIsSSR)();
+    let supportsBeforeMatch = !isSSR && 'onbeforematch' in document.body;
+    // @ts-ignore https://github.com/facebook/react/pull/24741
+    (0, $6wN6e$useEvent)(ref, 'beforematch', supportsBeforeMatch && !isControlled ? ()=>state.expand() : null);
+    (0, $6wN6e$useEffect)(()=>{
+        // Until React supports hidden="until-found": https://github.com/facebook/react/pull/24741
+        if (supportsBeforeMatch && (ref === null || ref === void 0 ? void 0 : ref.current) && !isControlled && !isDisabled) {
+            if (state.isExpanded) ref.current.removeAttribute('hidden');
+            else ref.current.setAttribute('hidden', 'until-found');
+        }
+    }, [
+        isControlled,
+        ref,
+        props.isExpanded,
+        state,
+        supportsBeforeMatch,
+        isDisabled
+    ]);
+    return {
+        buttonProps: {
+            id: triggerId,
+            'aria-expanded': state.isExpanded,
+            'aria-controls': contentId,
+            onPress: (e)=>{
+                if (!isDisabled && e.pointerType !== 'keyboard') state.toggle();
+            },
+            isDisabled: isDisabled,
+            onKeyDown (e) {
+                if (!isDisabled && (e.key === 'Enter' || e.key === ' ')) {
+                    e.preventDefault();
+                    state.toggle();
+                }
+            }
+        },
+        panelProps: {
+            id: contentId,
+            // This can be overridden at the panel element level.
+            role: 'group',
+            'aria-labelledby': triggerId,
+            hidden: !supportsBeforeMatch || isControlled ? !state.isExpanded : true
+        }
+    };
+}
+
+
+export {$5e910fae8e128ead$export$6e3e27031a30522f as useDisclosure};
+//# sourceMappingURL=useDisclosure.module.js.map

package/dist/useDisclosure.module.js.map

@@ -0,0 +1 @@
+{"mappings":";;;;AAAA;;;;;;;;;;CAUC;;;AAgCM,SAAS,0CAAc,KAA0B,EAAE,KAAsB,EAAE,GAA+B;IAC/G,IAAI,cACF,UAAU,EACX,GAAG;IACJ,IAAI,YAAY,CAAA,GAAA,YAAI;IACpB,IAAI,YAAY,CAAA,GAAA,YAAI;IACpB,IAAI,eAAe,MAAM,UAAU,KAAK;IACxC,IAAI,QAAQ,CAAA,GAAA,eAAO;IACnB,IAAI,sBAAsB,CAAC,SAAS,mBAAmB,SAAS,IAAI;IAEpE,0DAA0D;IAC1D,CAAA,GAAA,eAAO,EAAE,KAAK,eAAe,uBAAuB,CAAC,eAAe,IAAM,MAAM,MAAM,KAAK;IAE3F,CAAA,GAAA,gBAAQ,EAAE;QACR,0FAA0F;QAC1F,IAAI,wBAAuB,gBAAA,0BAAA,IAAK,OAAO,KAAI,CAAC,gBAAgB,CAAC;YAC3D,IAAI,MAAM,UAAU,EAClB,IAAI,OAAO,CAAC,eAAe,CAAC;iBAE5B,IAAI,OAAO,CAAC,YAAY,CAAC,UAAU;;IAGzC,GAAG;QAAC;QAAc;QAAK,MAAM,UAAU;QAAE;QAAO;QAAqB;KAAW;IAEhF,OAAO;QACL,aAAa;YACX,IAAI;YACJ,iBAAiB,MAAM,UAAU;YACjC,iBAAiB;YACjB,SAAS,CAAC;gBACR,IAAI,CAAC,cAAc,EAAE,WAAW,KAAK,YACnC,MAAM,MAAM;YAEhB;wBACA;YACA,WAAU,CAAC;gBACT,IAAI,CAAC,cAAe,CAAA,EAAE,GAAG,KAAK,WAAW,EAAE,GAAG,KAAK,GAAE,GAAI;oBACvD,EAAE,cAAc;oBAChB,MAAM,MAAM;gBACd;YACF;QACF;QACA,YAAY;YACV,IAAI;YACJ,qDAAqD;YACrD,MAAM;YACN,mBAAmB;YACnB,QAAQ,AAAC,CAAC,uBAAuB,eAAgB,CAAC,MAAM,UAAU,GAAG;QACvE;IACF;AACF","sources":["packages/@react-aria/disclosure/src/useDisclosure.ts"],"sourcesContent":["/*\n * Copyright 2024 Adobe. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the 'License');\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nimport {AriaButtonProps} from '@react-types/button';\nimport {DisclosureState} from '@react-stately/disclosure';\nimport {HTMLAttributes, RefObject, useEffect} from 'react';\nimport {useEvent, useId} from '@react-aria/utils';\nimport {useIsSSR} from '@react-aria/ssr';\n\nexport interface AriaDisclosureProps {\n  /** Whether the disclosure is disabled. */\n  isDisabled?: boolean,\n  /** Handler that is called when the disclosure's expanded state changes. */\n  onExpandedChange?: (isExpanded: boolean) => void,\n  /** Whether the disclosure is expanded (controlled). */\n  isExpanded?: boolean,\n  /** Whether the disclosure is expanded by default (uncontrolled). */\n  defaultExpanded?: boolean\n}\n\nexport interface DisclosureAria {\n  /** Props for the disclosure button. */\n  buttonProps: AriaButtonProps,\n  /** Props for the disclosure panel. */\n  panelProps: HTMLAttributes<HTMLElement>\n}\n\n/**\n * Provides the behavior and accessibility implementation for a disclosure component.\n * @param props - Props for the disclosure.\n * @param state - State for the disclosure, as returned by `useDisclosureState`.\n * @param ref - A ref for the disclosure content.\n */\nexport function useDisclosure(props: AriaDisclosureProps, state: DisclosureState, ref?: RefObject<Element | null>): DisclosureAria {\n  let {\n    isDisabled\n  } = props;\n  let triggerId = useId();\n  let contentId = useId();\n  let isControlled = props.isExpanded !== undefined;\n  let isSSR = useIsSSR();\n  let supportsBeforeMatch = !isSSR && 'onbeforematch' in document.body;\n\n  // @ts-ignore https://github.com/facebook/react/pull/24741\n  useEvent(ref, 'beforematch', supportsBeforeMatch && !isControlled ? () => state.expand() : null);\n\n  useEffect(() => {\n    // Until React supports hidden=\"until-found\": https://github.com/facebook/react/pull/24741\n    if (supportsBeforeMatch && ref?.current && !isControlled && !isDisabled) {\n      if (state.isExpanded) {\n        ref.current.removeAttribute('hidden');\n      } else {\n        ref.current.setAttribute('hidden', 'until-found');\n      }\n    }\n  }, [isControlled, ref, props.isExpanded, state, supportsBeforeMatch, isDisabled]);\n\n  return {\n    buttonProps: {\n      id: triggerId,\n      'aria-expanded': state.isExpanded,\n      'aria-controls': contentId,\n      onPress: (e) => {\n        if (!isDisabled && e.pointerType !== 'keyboard') {\n          state.toggle();\n        }\n      },\n      isDisabled,\n      onKeyDown(e) {\n        if (!isDisabled && (e.key === 'Enter' || e.key === ' ')) {\n          e.preventDefault();\n          state.toggle();\n        }\n      }\n    },\n    panelProps: {\n      id: contentId,\n      // This can be overridden at the panel element level.\n      role: 'group',\n      'aria-labelledby': triggerId,\n      hidden: (!supportsBeforeMatch || isControlled) ? !state.isExpanded : true\n    }\n  };\n}\n"],"names":[],"version":3,"file":"useDisclosure.module.js.map"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@react-aria/disclosure",
+  "version": "3.0.0-alpha.0",
+  "description": "Spectrum UI components in React",
+  "license": "Apache-2.0",
+  "main": "dist/main.js",
+  "module": "dist/module.js",
+  "exports": {
+    "types": "./dist/types.d.ts",
+    "import": "./dist/import.mjs",
+    "require": "./dist/main.js"
+  },
+  "types": "dist/types.d.ts",
+  "source": "src/index.ts",
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adobe/react-spectrum"
+  },
+  "dependencies": {
+    "@react-aria/button": "^3.10.0",
+    "@react-aria/selection": "^3.20.0",
+    "@react-aria/ssr": "^3.9.6",
+    "@react-aria/utils": "^3.25.3",
+    "@react-stately/disclosure": "3.0.0-alpha.0",
+    "@react-stately/toggle": "^3.7.8",
+    "@react-stately/tree": "^3.8.5",
+    "@react-types/button": "^3.10.0",
+    "@react-types/shared": "^3.25.0",
+    "@swc/helpers": "^0.5.0"
+  },
+  "peerDependencies": {
+    "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0",
+    "react-dom": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0 || ^19.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,13 @@
+/*
+ * Copyright 2020 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+export {useDisclosure} from './useDisclosure';
+export type {DisclosureAria, AriaDisclosureProps} from './useDisclosure';

package/src/useDisclosure.ts

@@ -0,0 +1,93 @@
+/*
+ * Copyright 2024 Adobe. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the 'License');
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+import {AriaButtonProps} from '@react-types/button';
+import {DisclosureState} from '@react-stately/disclosure';
+import {HTMLAttributes, RefObject, useEffect} from 'react';
+import {useEvent, useId} from '@react-aria/utils';
+import {useIsSSR} from '@react-aria/ssr';
+
+export interface AriaDisclosureProps {
+  /** Whether the disclosure is disabled. */
+  isDisabled?: boolean,
+  /** Handler that is called when the disclosure's expanded state changes. */
+  onExpandedChange?: (isExpanded: boolean) => void,
+  /** Whether the disclosure is expanded (controlled). */
+  isExpanded?: boolean,
+  /** Whether the disclosure is expanded by default (uncontrolled). */
+  defaultExpanded?: boolean
+}
+
+export interface DisclosureAria {
+  /** Props for the disclosure button. */
+  buttonProps: AriaButtonProps,
+  /** Props for the disclosure panel. */
+  panelProps: HTMLAttributes<HTMLElement>
+}
+
+/**
+ * Provides the behavior and accessibility implementation for a disclosure component.
+ * @param props - Props for the disclosure.
+ * @param state - State for the disclosure, as returned by `useDisclosureState`.
+ * @param ref - A ref for the disclosure content.
+ */
+export function useDisclosure(props: AriaDisclosureProps, state: DisclosureState, ref?: RefObject<Element | null>): DisclosureAria {
+  let {
+    isDisabled
+  } = props;
+  let triggerId = useId();
+  let contentId = useId();
+  let isControlled = props.isExpanded !== undefined;
+  let isSSR = useIsSSR();
+  let supportsBeforeMatch = !isSSR && 'onbeforematch' in document.body;
+
+  // @ts-ignore https://github.com/facebook/react/pull/24741
+  useEvent(ref, 'beforematch', supportsBeforeMatch && !isControlled ? () => state.expand() : null);
+
+  useEffect(() => {
+    // Until React supports hidden="until-found": https://github.com/facebook/react/pull/24741
+    if (supportsBeforeMatch && ref?.current && !isControlled && !isDisabled) {
+      if (state.isExpanded) {
+        ref.current.removeAttribute('hidden');
+      } else {
+        ref.current.setAttribute('hidden', 'until-found');
+      }
+    }
+  }, [isControlled, ref, props.isExpanded, state, supportsBeforeMatch, isDisabled]);
+
+  return {
+    buttonProps: {
+      id: triggerId,
+      'aria-expanded': state.isExpanded,
+      'aria-controls': contentId,
+      onPress: (e) => {
+        if (!isDisabled && e.pointerType !== 'keyboard') {
+          state.toggle();
+        }
+      },
+      isDisabled,
+      onKeyDown(e) {
+        if (!isDisabled && (e.key === 'Enter' || e.key === ' ')) {
+          e.preventDefault();
+          state.toggle();
+        }
+      }
+    },
+    panelProps: {
+      id: contentId,
+      // This can be overridden at the panel element level.
+      role: 'group',
+      'aria-labelledby': triggerId,
+      hidden: (!supportsBeforeMatch || isControlled) ? !state.isExpanded : true
+    }
+  };
+}