@react-aria/collections 3.0.0-alpha.1 → 3.0.0-nightly.2988

package/dist/CollectionBuilder.main.js

@@ -0,0 +1,233 @@
+var $499e2959ba1abacc$exports = require("./BaseCollection.main.js");
+var $c20afee375f3b2d6$exports = require("./Document.main.js");
+var $245f3f827bea6653$exports = require("./useCachedChildren.main.js");
+var $eaaf60978b89fc58$exports = require("./Hidden.main.js");
+var $4ftIM$reactdom = require("react-dom");
+var $4ftIM$react = require("react");
+var $4ftIM$reactariassr = require("@react-aria/ssr");
+var $4ftIM$reactariautils = require("@react-aria/utils");
+var $4ftIM$usesyncexternalstoreshimindexjs = require("use-sync-external-store/shim/index.js");
+
+
+function $parcel$interopDefault(a) {
+  return a && a.__esModule ? a.default : a;
+}
+
+function $parcel$export(e, n, v, s) {
+  Object.defineProperty(e, n, {get: v, set: s, enumerable: true, configurable: true});
+}
+
+$parcel$export(module.exports, "CollectionBuilder", () => $f20386e2aa690b4a$export$bf788dd355e3a401);
+$parcel$export(module.exports, "createLeafComponent", () => $f20386e2aa690b4a$export$18af5c7a9e9b3664);
+$parcel$export(module.exports, "createBranchComponent", () => $f20386e2aa690b4a$export$e953bb1cd0f19726);
+$parcel$export(module.exports, "Collection", () => $f20386e2aa690b4a$export$fb8073518f34e6ec);
+/*
+ * 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.
+ */ 
+
+
+
+
+
+
+
+
+const $f20386e2aa690b4a$var$ShallowRenderContext = /*#__PURE__*/ (0, $4ftIM$react.createContext)(false);
+const $f20386e2aa690b4a$var$CollectionDocumentContext = /*#__PURE__*/ (0, $4ftIM$react.createContext)(null);
+function $f20386e2aa690b4a$export$bf788dd355e3a401(props) {
+    // If a document was provided above us, we're already in a hidden tree. Just render the content.
+    let doc = (0, $4ftIM$react.useContext)($f20386e2aa690b4a$var$CollectionDocumentContext);
+    if (doc) return props.content;
+    // Otherwise, render a hidden copy of the children so that we can build the collection before constructing the state.
+    // This should always come before the real DOM content so we have built the collection by the time it renders during SSR.
+    // This is fine. CollectionDocumentContext never changes after mounting.
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    let { collection: collection, document: document } = $f20386e2aa690b4a$var$useCollectionDocument(props.createCollection);
+    return /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement((0, ($parcel$interopDefault($4ftIM$react))).Fragment, null, /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement((0, $eaaf60978b89fc58$exports.Hidden), null, /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement($f20386e2aa690b4a$var$CollectionDocumentContext.Provider, {
+        value: document
+    }, props.content)), /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement($f20386e2aa690b4a$var$CollectionInner, {
+        render: props.children,
+        collection: collection
+    }));
+}
+function $f20386e2aa690b4a$var$CollectionInner({ collection: collection, render: render }) {
+    return render(collection);
+}
+// React 16 and 17 don't support useSyncExternalStore natively, and the shim provided by React does not support getServerSnapshot.
+// This wrapper uses the shim, but additionally calls getServerSnapshot during SSR (according to SSRProvider).
+function $f20386e2aa690b4a$var$useSyncExternalStoreFallback(subscribe, getSnapshot, getServerSnapshot) {
+    let isSSR = (0, $4ftIM$reactariassr.useIsSSR)();
+    let isSSRRef = (0, $4ftIM$react.useRef)(isSSR);
+    // This is read immediately inside the wrapper, which also runs during render.
+    // We just need a ref to avoid invalidating the callback itself, which
+    // would cause React to re-run the callback more than necessary.
+    // eslint-disable-next-line rulesdir/pure-render
+    isSSRRef.current = isSSR;
+    let getSnapshotWrapper = (0, $4ftIM$react.useCallback)(()=>{
+        return isSSRRef.current ? getServerSnapshot() : getSnapshot();
+    }, [
+        getSnapshot,
+        getServerSnapshot
+    ]);
+    return (0, $4ftIM$usesyncexternalstoreshimindexjs.useSyncExternalStore)(subscribe, getSnapshotWrapper);
+}
+const $f20386e2aa690b4a$var$useSyncExternalStore = typeof (0, ($parcel$interopDefault($4ftIM$react)))['useSyncExternalStore'] === 'function' ? (0, ($parcel$interopDefault($4ftIM$react)))['useSyncExternalStore'] : $f20386e2aa690b4a$var$useSyncExternalStoreFallback;
+function $f20386e2aa690b4a$var$useCollectionDocument(createCollection) {
+    // The document instance is mutable, and should never change between renders.
+    // useSyncExternalStore is used to subscribe to updates, which vends immutable Collection objects.
+    let [document] = (0, $4ftIM$react.useState)(()=>new (0, $c20afee375f3b2d6$exports.Document)((createCollection === null || createCollection === void 0 ? void 0 : createCollection()) || new (0, $499e2959ba1abacc$exports.BaseCollection)()));
+    let subscribe = (0, $4ftIM$react.useCallback)((fn)=>document.subscribe(fn), [
+        document
+    ]);
+    let getSnapshot = (0, $4ftIM$react.useCallback)(()=>{
+        let collection = document.getCollection();
+        if (document.isSSR) // After SSR is complete, reset the document to empty so it is ready for React to render the portal into.
+        // We do this _after_ getting the collection above so that the collection still has content in it from SSR
+        // during the current render, before React has finished the client render.
+        document.resetAfterSSR();
+        return collection;
+    }, [
+        document
+    ]);
+    let getServerSnapshot = (0, $4ftIM$react.useCallback)(()=>{
+        document.isSSR = true;
+        return document.getCollection();
+    }, [
+        document
+    ]);
+    let collection = $f20386e2aa690b4a$var$useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+    (0, $4ftIM$reactariautils.useLayoutEffect)(()=>{
+        document.isMounted = true;
+        return ()=>{
+            // Mark unmounted so we can skip all of the collection updates caused by 
+            // React calling removeChild on every item in the collection.
+            document.isMounted = false;
+        };
+    }, [
+        document
+    ]);
+    return {
+        collection: collection,
+        document: document
+    };
+}
+const $f20386e2aa690b4a$var$SSRContext = /*#__PURE__*/ (0, $4ftIM$react.createContext)(null);
+function $f20386e2aa690b4a$var$useSSRCollectionNode(Type, props, ref, rendered, children, render) {
+    // During SSR, portals are not supported, so the collection children will be wrapped in an SSRContext.
+    // Since SSR occurs only once, we assume that the elements are rendered in order and never re-render.
+    // Therefore we can create elements in our collection document during render so that they are in the
+    // collection by the time we need to use the collection to render to the real DOM.
+    // After hydration, we switch to client rendering using the portal.
+    let itemRef = (0, $4ftIM$react.useCallback)((element)=>{
+        element === null || element === void 0 ? void 0 : element.setProps(props, ref, rendered, render);
+    }, [
+        props,
+        ref,
+        rendered,
+        render
+    ]);
+    let parentNode = (0, $4ftIM$react.useContext)($f20386e2aa690b4a$var$SSRContext);
+    if (parentNode) {
+        // Guard against double rendering in strict mode.
+        let element = parentNode.ownerDocument.nodesByProps.get(props);
+        if (!element) {
+            element = parentNode.ownerDocument.createElement(Type);
+            element.setProps(props, ref, rendered, render);
+            parentNode.appendChild(element);
+            parentNode.ownerDocument.updateCollection();
+            parentNode.ownerDocument.nodesByProps.set(props, element);
+        }
+        return children ? /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement($f20386e2aa690b4a$var$SSRContext.Provider, {
+            value: element
+        }, children) : null;
+    }
+    // @ts-ignore
+    return /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement(Type, {
+        ref: itemRef
+    }, children);
+}
+function $f20386e2aa690b4a$export$18af5c7a9e9b3664(type, render) {
+    let Component = ({ node: node })=>render(node.props, node.props.ref, node);
+    let Result = (0, $4ftIM$react.forwardRef)((props, ref)=>{
+        let isShallow = (0, $4ftIM$react.useContext)($f20386e2aa690b4a$var$ShallowRenderContext);
+        if (!isShallow) {
+            if (render.length >= 3) throw new Error(render.name + ' cannot be rendered outside a collection.');
+            return render(props, ref);
+        }
+        return $f20386e2aa690b4a$var$useSSRCollectionNode(type, props, ref, 'children' in props ? props.children : null, null, (node)=>/*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement(Component, {
+                node: node
+            }));
+    });
+    // @ts-ignore
+    Result.displayName = render.name;
+    return Result;
+}
+function $f20386e2aa690b4a$export$e953bb1cd0f19726(type, render, useChildren = $f20386e2aa690b4a$var$useCollectionChildren) {
+    let Component = ({ node: node })=>render(node.props, node.props.ref, node);
+    let Result = (0, $4ftIM$react.forwardRef)((props, ref)=>{
+        let children = useChildren(props);
+        var _useSSRCollectionNode;
+        return (_useSSRCollectionNode = $f20386e2aa690b4a$var$useSSRCollectionNode(type, props, ref, null, children, (node)=>/*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement(Component, {
+                node: node
+            }))) !== null && _useSSRCollectionNode !== void 0 ? _useSSRCollectionNode : /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement((0, ($parcel$interopDefault($4ftIM$react))).Fragment, null);
+    });
+    // @ts-ignore
+    Result.displayName = render.name;
+    return Result;
+}
+function $f20386e2aa690b4a$var$useCollectionChildren(options) {
+    return (0, $245f3f827bea6653$exports.useCachedChildren)({
+        ...options,
+        addIdAndValue: true
+    });
+}
+const $f20386e2aa690b4a$var$CollectionContext = /*#__PURE__*/ (0, $4ftIM$react.createContext)(null);
+function $f20386e2aa690b4a$export$fb8073518f34e6ec(props) {
+    let ctx = (0, $4ftIM$react.useContext)($f20386e2aa690b4a$var$CollectionContext);
+    let dependencies = ((ctx === null || ctx === void 0 ? void 0 : ctx.dependencies) || []).concat(props.dependencies);
+    let idScope = props.idScope || (ctx === null || ctx === void 0 ? void 0 : ctx.idScope);
+    let children = $f20386e2aa690b4a$var$useCollectionChildren({
+        ...props,
+        idScope: idScope,
+        dependencies: dependencies
+    });
+    let doc = (0, $4ftIM$react.useContext)($f20386e2aa690b4a$var$CollectionDocumentContext);
+    if (doc) children = /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement($f20386e2aa690b4a$var$CollectionRoot, null, children);
+    // Propagate dependencies and idScope to child collections.
+    ctx = (0, $4ftIM$react.useMemo)(()=>({
+            dependencies: dependencies,
+            idScope: idScope
+        }), [
+        idScope,
+        ...dependencies
+    ]);
+    return /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement($f20386e2aa690b4a$var$CollectionContext.Provider, {
+        value: ctx
+    }, children);
+}
+function $f20386e2aa690b4a$var$CollectionRoot({ children: children }) {
+    let doc = (0, $4ftIM$react.useContext)($f20386e2aa690b4a$var$CollectionDocumentContext);
+    let wrappedChildren = (0, $4ftIM$react.useMemo)(()=>/*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement($f20386e2aa690b4a$var$CollectionDocumentContext.Provider, {
+            value: null
+        }, /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement($f20386e2aa690b4a$var$ShallowRenderContext.Provider, {
+            value: true
+        }, children)), [
+        children
+    ]);
+    // During SSR, we render the content directly, and append nodes to the document during render.
+    // The collection children return null so that nothing is actually rendered into the HTML.
+    return (0, $4ftIM$reactariassr.useIsSSR)() ? /*#__PURE__*/ (0, ($parcel$interopDefault($4ftIM$react))).createElement($f20386e2aa690b4a$var$SSRContext.Provider, {
+        value: doc
+    }, wrappedChildren) : /*#__PURE__*/ (0, $4ftIM$reactdom.createPortal)(wrappedChildren, doc);
+}
+
+
+//# sourceMappingURL=CollectionBuilder.main.js.map

package/dist/CollectionBuilder.main.js.map

@@ -0,0 +1 @@
+{"mappings":"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","sources":["packages/@react-aria/collections/src/CollectionBuilder.tsx"],"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 {BaseCollection} from './BaseCollection';\nimport {BaseNode, Document, ElementNode} from './Document';\nimport {CachedChildrenOptions, useCachedChildren} from './useCachedChildren';\nimport {createPortal} from 'react-dom';\nimport {forwardRefType, Node} from '@react-types/shared';\nimport {Hidden} from './Hidden';\nimport React, {createContext, ForwardedRef, forwardRef, JSX, ReactElement, ReactNode, useCallback, useContext, useMemo, useRef, useState} from 'react';\nimport {useIsSSR} from '@react-aria/ssr';\nimport {useLayoutEffect} from '@react-aria/utils';\nimport {useSyncExternalStore as useSyncExternalStoreShim} from 'use-sync-external-store/shim/index.js';\n\nconst ShallowRenderContext = createContext(false);\nconst CollectionDocumentContext = createContext<Document<any, BaseCollection<any>> | null>(null);\n\nexport interface CollectionBuilderProps<C extends BaseCollection<object>> {\n  content: ReactNode,\n  children: (collection: C) => ReactNode,\n  createCollection?: () => C\n}\n\n/**\n * Builds a `Collection` from the children provided to the `content` prop, and passes it to the child render prop function.\n */\nexport function CollectionBuilder<C extends BaseCollection<object>>(props: CollectionBuilderProps<C>) {\n  // If a document was provided above us, we're already in a hidden tree. Just render the content.\n  let doc = useContext(CollectionDocumentContext);\n  if (doc) {\n    return props.content;\n  }\n\n  // Otherwise, render a hidden copy of the children so that we can build the collection before constructing the state.\n  // This should always come before the real DOM content so we have built the collection by the time it renders during SSR.\n\n  // This is fine. CollectionDocumentContext never changes after mounting.\n  // eslint-disable-next-line react-hooks/rules-of-hooks\n  let {collection, document} = useCollectionDocument(props.createCollection);\n  return (\n    <>\n      <Hidden>\n        <CollectionDocumentContext.Provider value={document}>\n          {props.content}\n        </CollectionDocumentContext.Provider>\n      </Hidden>\n      <CollectionInner render={props.children} collection={collection} />\n    </>\n  );\n}\n\nfunction CollectionInner({collection, render}) {\n  return render(collection);\n}\n\ninterface CollectionDocumentResult<T, C extends BaseCollection<T>> {\n  collection: C,\n  document: Document<T, C>\n}\n\n// React 16 and 17 don't support useSyncExternalStore natively, and the shim provided by React does not support getServerSnapshot.\n// This wrapper uses the shim, but additionally calls getServerSnapshot during SSR (according to SSRProvider).\nfunction useSyncExternalStoreFallback<C>(subscribe: (onStoreChange: () => void) => () => void, getSnapshot: () => C, getServerSnapshot: () => C): C {\n  let isSSR = useIsSSR();\n  let isSSRRef = useRef(isSSR);\n  // This is read immediately inside the wrapper, which also runs during render.\n  // We just need a ref to avoid invalidating the callback itself, which\n  // would cause React to re-run the callback more than necessary.\n  // eslint-disable-next-line rulesdir/pure-render\n  isSSRRef.current = isSSR;\n\n  let getSnapshotWrapper = useCallback(() => {\n    return isSSRRef.current ? getServerSnapshot() : getSnapshot();\n  }, [getSnapshot, getServerSnapshot]);\n  return useSyncExternalStoreShim(subscribe, getSnapshotWrapper);\n}\n\nconst useSyncExternalStore = typeof React['useSyncExternalStore'] === 'function'\n  ? React['useSyncExternalStore']\n  : useSyncExternalStoreFallback;\n\nfunction useCollectionDocument<T extends object, C extends BaseCollection<T>>(createCollection?: () => C): CollectionDocumentResult<T, C> {\n  // The document instance is mutable, and should never change between renders.\n  // useSyncExternalStore is used to subscribe to updates, which vends immutable Collection objects.\n  let [document] = useState(() => new Document<T, C>(createCollection?.() || new BaseCollection() as C));\n  let subscribe = useCallback((fn: () => void) => document.subscribe(fn), [document]);\n  let getSnapshot = useCallback(() => {\n    let collection = document.getCollection();\n    if (document.isSSR) {\n      // After SSR is complete, reset the document to empty so it is ready for React to render the portal into.\n      // We do this _after_ getting the collection above so that the collection still has content in it from SSR\n      // during the current render, before React has finished the client render.\n      document.resetAfterSSR();\n    }\n    return collection;\n  }, [document]);\n  let getServerSnapshot = useCallback(() => {\n    document.isSSR = true;\n    return document.getCollection();\n  }, [document]);\n  let collection = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);\n  useLayoutEffect(() => {\n    document.isMounted = true;\n    return () => {\n      // Mark unmounted so we can skip all of the collection updates caused by \n      // React calling removeChild on every item in the collection.\n      document.isMounted = false;\n    };\n  }, [document]);\n  return {collection, document};\n}\n\nconst SSRContext = createContext<BaseNode<any> | null>(null);\n\nfunction useSSRCollectionNode<T extends Element>(Type: string, props: object, ref: ForwardedRef<T>, rendered?: any, children?: ReactNode, render?: (node: Node<T>) => ReactElement) {\n  // During SSR, portals are not supported, so the collection children will be wrapped in an SSRContext.\n  // Since SSR occurs only once, we assume that the elements are rendered in order and never re-render.\n  // Therefore we can create elements in our collection document during render so that they are in the\n  // collection by the time we need to use the collection to render to the real DOM.\n  // After hydration, we switch to client rendering using the portal.\n  let itemRef = useCallback((element: ElementNode<any> | null) => {\n    element?.setProps(props, ref, rendered, render);\n  }, [props, ref, rendered, render]);\n  let parentNode = useContext(SSRContext);\n  if (parentNode) {\n    // Guard against double rendering in strict mode.\n    let element = parentNode.ownerDocument.nodesByProps.get(props);\n    if (!element) {\n      element = parentNode.ownerDocument.createElement(Type);\n      element.setProps(props, ref, rendered, render);\n      parentNode.appendChild(element);\n      parentNode.ownerDocument.updateCollection();\n      parentNode.ownerDocument.nodesByProps.set(props, element);\n    }\n\n    return children\n      ? <SSRContext.Provider value={element}>{children}</SSRContext.Provider>\n      : null;\n  }\n\n  // @ts-ignore\n  return <Type ref={itemRef}>{children}</Type>;\n}\n\nexport function createLeafComponent<T extends object, P extends object, E extends Element>(type: string, render: (props: P, ref: ForwardedRef<E>) => ReactNode): (props: P & React.RefAttributes<T>) => ReactNode | null;\nexport function createLeafComponent<T extends object, P extends object, E extends Element>(type: string, render: (props: P, ref: ForwardedRef<E>, node: Node<T>) => ReactNode): (props: P & React.RefAttributes<T>) => ReactNode | null;\nexport function createLeafComponent<P extends object, E extends Element>(type: string, render: (props: P, ref: ForwardedRef<E>, node?: any) => ReactNode) {\n  let Component = ({node}) => render(node.props, node.props.ref, node);\n  let Result = (forwardRef as forwardRefType)((props: P, ref: ForwardedRef<E>) => {\n    let isShallow = useContext(ShallowRenderContext);\n    if (!isShallow) {\n      if (render.length >= 3) {\n        throw new Error(render.name + ' cannot be rendered outside a collection.');\n      }\n      return render(props, ref);\n    }\n\n    return useSSRCollectionNode(type, props, ref, 'children' in props ? props.children : null, null, node => <Component node={node} />);\n  });\n  // @ts-ignore\n  Result.displayName = render.name;\n  return Result;\n}\n\nexport function createBranchComponent<T extends object, P extends {children?: any}, E extends Element>(type: string, render: (props: P, ref: ForwardedRef<E>, node: Node<T>) => ReactNode, useChildren: (props: P) => ReactNode = useCollectionChildren) {\n  let Component = ({node}) => render(node.props, node.props.ref, node);\n  let Result = (forwardRef as forwardRefType)((props: P, ref: ForwardedRef<E>) => {\n    let children = useChildren(props);\n    return useSSRCollectionNode(type, props, ref, null, children, node => <Component node={node} />) ?? <></>;\n  });\n  // @ts-ignore\n  Result.displayName = render.name;\n  return Result;\n}\n\nfunction useCollectionChildren<T extends object>(options: CachedChildrenOptions<T>) {\n  return useCachedChildren({...options, addIdAndValue: true});\n}\n\nexport interface CollectionProps<T> extends CachedChildrenOptions<T> {}\n\nconst CollectionContext = createContext<CachedChildrenOptions<unknown> | null>(null);\n\n/** A Collection renders a list of items, automatically managing caching and keys. */\nexport function Collection<T extends object>(props: CollectionProps<T>): JSX.Element {\n  let ctx = useContext(CollectionContext)!;\n  let dependencies = (ctx?.dependencies || []).concat(props.dependencies);\n  let idScope = props.idScope || ctx?.idScope;\n  let children = useCollectionChildren({\n    ...props,\n    idScope,\n    dependencies\n  });\n\n  let doc = useContext(CollectionDocumentContext);\n  if (doc) {\n    children = <CollectionRoot>{children}</CollectionRoot>;\n  }\n\n  // Propagate dependencies and idScope to child collections.\n  ctx = useMemo(() => ({\n    dependencies,\n    idScope\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }), [idScope, ...dependencies]);\n\n  return (\n    <CollectionContext.Provider value={ctx}>\n      {children}\n    </CollectionContext.Provider>\n  );\n}\n\nfunction CollectionRoot({children}) {\n  let doc = useContext(CollectionDocumentContext);\n  let wrappedChildren = useMemo(() => (\n    <CollectionDocumentContext.Provider value={null}>\n      <ShallowRenderContext.Provider value>\n        {children}\n      </ShallowRenderContext.Provider>\n    </CollectionDocumentContext.Provider>\n  ), [children]);\n  // During SSR, we render the content directly, and append nodes to the document during render.\n  // The collection children return null so that nothing is actually rendered into the HTML.\n  return useIsSSR()\n    ? <SSRContext.Provider value={doc}>{wrappedChildren}</SSRContext.Provider>\n    : createPortal(wrappedChildren, doc as unknown as Element);\n}\n"],"names":[],"version":3,"file":"CollectionBuilder.main.js.map"}

package/dist/CollectionBuilder.mjs

@@ -0,0 +1,221 @@
+import {BaseCollection as $23b9f4fcf0fe224b$export$408d25a4e12db025} from "./BaseCollection.mjs";
+import {Document as $681cc3c98f569e39$export$b34a105447964f9f} from "./Document.mjs";
+import {useCachedChildren as $e948873055cbafe4$export$727c8fc270210f13} from "./useCachedChildren.mjs";
+import {Hidden as $f39a9eba43920ace$export$8dc98ba7eadeaa56} from "./Hidden.mjs";
+import {createPortal as $95feo$createPortal} from "react-dom";
+import $95feo$react, {createContext as $95feo$createContext, useContext as $95feo$useContext, useRef as $95feo$useRef, useCallback as $95feo$useCallback, useState as $95feo$useState, forwardRef as $95feo$forwardRef, useMemo as $95feo$useMemo} from "react";
+import {useIsSSR as $95feo$useIsSSR} from "@react-aria/ssr";
+import {useLayoutEffect as $95feo$useLayoutEffect} from "@react-aria/utils";
+import {useSyncExternalStore as $95feo$useSyncExternalStore} from "use-sync-external-store/shim/index.js";
+
+/*
+ * 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.
+ */ 
+
+
+
+
+
+
+
+
+const $e1995378a142960e$var$ShallowRenderContext = /*#__PURE__*/ (0, $95feo$createContext)(false);
+const $e1995378a142960e$var$CollectionDocumentContext = /*#__PURE__*/ (0, $95feo$createContext)(null);
+function $e1995378a142960e$export$bf788dd355e3a401(props) {
+    // If a document was provided above us, we're already in a hidden tree. Just render the content.
+    let doc = (0, $95feo$useContext)($e1995378a142960e$var$CollectionDocumentContext);
+    if (doc) return props.content;
+    // Otherwise, render a hidden copy of the children so that we can build the collection before constructing the state.
+    // This should always come before the real DOM content so we have built the collection by the time it renders during SSR.
+    // This is fine. CollectionDocumentContext never changes after mounting.
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    let { collection: collection, document: document } = $e1995378a142960e$var$useCollectionDocument(props.createCollection);
+    return /*#__PURE__*/ (0, $95feo$react).createElement((0, $95feo$react).Fragment, null, /*#__PURE__*/ (0, $95feo$react).createElement((0, $f39a9eba43920ace$export$8dc98ba7eadeaa56), null, /*#__PURE__*/ (0, $95feo$react).createElement($e1995378a142960e$var$CollectionDocumentContext.Provider, {
+        value: document
+    }, props.content)), /*#__PURE__*/ (0, $95feo$react).createElement($e1995378a142960e$var$CollectionInner, {
+        render: props.children,
+        collection: collection
+    }));
+}
+function $e1995378a142960e$var$CollectionInner({ collection: collection, render: render }) {
+    return render(collection);
+}
+// React 16 and 17 don't support useSyncExternalStore natively, and the shim provided by React does not support getServerSnapshot.
+// This wrapper uses the shim, but additionally calls getServerSnapshot during SSR (according to SSRProvider).
+function $e1995378a142960e$var$useSyncExternalStoreFallback(subscribe, getSnapshot, getServerSnapshot) {
+    let isSSR = (0, $95feo$useIsSSR)();
+    let isSSRRef = (0, $95feo$useRef)(isSSR);
+    // This is read immediately inside the wrapper, which also runs during render.
+    // We just need a ref to avoid invalidating the callback itself, which
+    // would cause React to re-run the callback more than necessary.
+    // eslint-disable-next-line rulesdir/pure-render
+    isSSRRef.current = isSSR;
+    let getSnapshotWrapper = (0, $95feo$useCallback)(()=>{
+        return isSSRRef.current ? getServerSnapshot() : getSnapshot();
+    }, [
+        getSnapshot,
+        getServerSnapshot
+    ]);
+    return (0, $95feo$useSyncExternalStore)(subscribe, getSnapshotWrapper);
+}
+const $e1995378a142960e$var$useSyncExternalStore = typeof (0, $95feo$react)['useSyncExternalStore'] === 'function' ? (0, $95feo$react)['useSyncExternalStore'] : $e1995378a142960e$var$useSyncExternalStoreFallback;
+function $e1995378a142960e$var$useCollectionDocument(createCollection) {
+    // The document instance is mutable, and should never change between renders.
+    // useSyncExternalStore is used to subscribe to updates, which vends immutable Collection objects.
+    let [document] = (0, $95feo$useState)(()=>new (0, $681cc3c98f569e39$export$b34a105447964f9f)((createCollection === null || createCollection === void 0 ? void 0 : createCollection()) || new (0, $23b9f4fcf0fe224b$export$408d25a4e12db025)()));
+    let subscribe = (0, $95feo$useCallback)((fn)=>document.subscribe(fn), [
+        document
+    ]);
+    let getSnapshot = (0, $95feo$useCallback)(()=>{
+        let collection = document.getCollection();
+        if (document.isSSR) // After SSR is complete, reset the document to empty so it is ready for React to render the portal into.
+        // We do this _after_ getting the collection above so that the collection still has content in it from SSR
+        // during the current render, before React has finished the client render.
+        document.resetAfterSSR();
+        return collection;
+    }, [
+        document
+    ]);
+    let getServerSnapshot = (0, $95feo$useCallback)(()=>{
+        document.isSSR = true;
+        return document.getCollection();
+    }, [
+        document
+    ]);
+    let collection = $e1995378a142960e$var$useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+    (0, $95feo$useLayoutEffect)(()=>{
+        document.isMounted = true;
+        return ()=>{
+            // Mark unmounted so we can skip all of the collection updates caused by 
+            // React calling removeChild on every item in the collection.
+            document.isMounted = false;
+        };
+    }, [
+        document
+    ]);
+    return {
+        collection: collection,
+        document: document
+    };
+}
+const $e1995378a142960e$var$SSRContext = /*#__PURE__*/ (0, $95feo$createContext)(null);
+function $e1995378a142960e$var$useSSRCollectionNode(Type, props, ref, rendered, children, render) {
+    // During SSR, portals are not supported, so the collection children will be wrapped in an SSRContext.
+    // Since SSR occurs only once, we assume that the elements are rendered in order and never re-render.
+    // Therefore we can create elements in our collection document during render so that they are in the
+    // collection by the time we need to use the collection to render to the real DOM.
+    // After hydration, we switch to client rendering using the portal.
+    let itemRef = (0, $95feo$useCallback)((element)=>{
+        element === null || element === void 0 ? void 0 : element.setProps(props, ref, rendered, render);
+    }, [
+        props,
+        ref,
+        rendered,
+        render
+    ]);
+    let parentNode = (0, $95feo$useContext)($e1995378a142960e$var$SSRContext);
+    if (parentNode) {
+        // Guard against double rendering in strict mode.
+        let element = parentNode.ownerDocument.nodesByProps.get(props);
+        if (!element) {
+            element = parentNode.ownerDocument.createElement(Type);
+            element.setProps(props, ref, rendered, render);
+            parentNode.appendChild(element);
+            parentNode.ownerDocument.updateCollection();
+            parentNode.ownerDocument.nodesByProps.set(props, element);
+        }
+        return children ? /*#__PURE__*/ (0, $95feo$react).createElement($e1995378a142960e$var$SSRContext.Provider, {
+            value: element
+        }, children) : null;
+    }
+    // @ts-ignore
+    return /*#__PURE__*/ (0, $95feo$react).createElement(Type, {
+        ref: itemRef
+    }, children);
+}
+function $e1995378a142960e$export$18af5c7a9e9b3664(type, render) {
+    let Component = ({ node: node })=>render(node.props, node.props.ref, node);
+    let Result = (0, $95feo$forwardRef)((props, ref)=>{
+        let isShallow = (0, $95feo$useContext)($e1995378a142960e$var$ShallowRenderContext);
+        if (!isShallow) {
+            if (render.length >= 3) throw new Error(render.name + ' cannot be rendered outside a collection.');
+            return render(props, ref);
+        }
+        return $e1995378a142960e$var$useSSRCollectionNode(type, props, ref, 'children' in props ? props.children : null, null, (node)=>/*#__PURE__*/ (0, $95feo$react).createElement(Component, {
+                node: node
+            }));
+    });
+    // @ts-ignore
+    Result.displayName = render.name;
+    return Result;
+}
+function $e1995378a142960e$export$e953bb1cd0f19726(type, render, useChildren = $e1995378a142960e$var$useCollectionChildren) {
+    let Component = ({ node: node })=>render(node.props, node.props.ref, node);
+    let Result = (0, $95feo$forwardRef)((props, ref)=>{
+        let children = useChildren(props);
+        var _useSSRCollectionNode;
+        return (_useSSRCollectionNode = $e1995378a142960e$var$useSSRCollectionNode(type, props, ref, null, children, (node)=>/*#__PURE__*/ (0, $95feo$react).createElement(Component, {
+                node: node
+            }))) !== null && _useSSRCollectionNode !== void 0 ? _useSSRCollectionNode : /*#__PURE__*/ (0, $95feo$react).createElement((0, $95feo$react).Fragment, null);
+    });
+    // @ts-ignore
+    Result.displayName = render.name;
+    return Result;
+}
+function $e1995378a142960e$var$useCollectionChildren(options) {
+    return (0, $e948873055cbafe4$export$727c8fc270210f13)({
+        ...options,
+        addIdAndValue: true
+    });
+}
+const $e1995378a142960e$var$CollectionContext = /*#__PURE__*/ (0, $95feo$createContext)(null);
+function $e1995378a142960e$export$fb8073518f34e6ec(props) {
+    let ctx = (0, $95feo$useContext)($e1995378a142960e$var$CollectionContext);
+    let dependencies = ((ctx === null || ctx === void 0 ? void 0 : ctx.dependencies) || []).concat(props.dependencies);
+    let idScope = props.idScope || (ctx === null || ctx === void 0 ? void 0 : ctx.idScope);
+    let children = $e1995378a142960e$var$useCollectionChildren({
+        ...props,
+        idScope: idScope,
+        dependencies: dependencies
+    });
+    let doc = (0, $95feo$useContext)($e1995378a142960e$var$CollectionDocumentContext);
+    if (doc) children = /*#__PURE__*/ (0, $95feo$react).createElement($e1995378a142960e$var$CollectionRoot, null, children);
+    // Propagate dependencies and idScope to child collections.
+    ctx = (0, $95feo$useMemo)(()=>({
+            dependencies: dependencies,
+            idScope: idScope
+        }), [
+        idScope,
+        ...dependencies
+    ]);
+    return /*#__PURE__*/ (0, $95feo$react).createElement($e1995378a142960e$var$CollectionContext.Provider, {
+        value: ctx
+    }, children);
+}
+function $e1995378a142960e$var$CollectionRoot({ children: children }) {
+    let doc = (0, $95feo$useContext)($e1995378a142960e$var$CollectionDocumentContext);
+    let wrappedChildren = (0, $95feo$useMemo)(()=>/*#__PURE__*/ (0, $95feo$react).createElement($e1995378a142960e$var$CollectionDocumentContext.Provider, {
+            value: null
+        }, /*#__PURE__*/ (0, $95feo$react).createElement($e1995378a142960e$var$ShallowRenderContext.Provider, {
+            value: true
+        }, children)), [
+        children
+    ]);
+    // During SSR, we render the content directly, and append nodes to the document during render.
+    // The collection children return null so that nothing is actually rendered into the HTML.
+    return (0, $95feo$useIsSSR)() ? /*#__PURE__*/ (0, $95feo$react).createElement($e1995378a142960e$var$SSRContext.Provider, {
+        value: doc
+    }, wrappedChildren) : /*#__PURE__*/ (0, $95feo$createPortal)(wrappedChildren, doc);
+}
+
+
+export {$e1995378a142960e$export$bf788dd355e3a401 as CollectionBuilder, $e1995378a142960e$export$18af5c7a9e9b3664 as createLeafComponent, $e1995378a142960e$export$e953bb1cd0f19726 as createBranchComponent, $e1995378a142960e$export$fb8073518f34e6ec as Collection};
+//# sourceMappingURL=CollectionBuilder.module.js.map