/*
 * Copyright 2026 Hypergiant Galactic Systems Inc. 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 https://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 { DeferredCollectionProps } from "./types.js";
import * as react_jsx_runtime19 from "react/jsx-runtime";

//#region src/components/deferred-collection/index.d.ts

/**
 * DeferredCollection - Defers rendering of large collections to prevent UI freezes.
 *
 * React Aria's collection system processes ALL items synchronously before
 * virtualization begins. This component defers the collection render by a few
 * animation frames, allowing a fallback to display first.
 *
 * @param props - The deferred collection props.
 * @param props.children - Content to render once ready (ReactNode or function returning ReactNode).
 * @param props.fallback - Fallback element to show while deferring render.
 * @param props.deferFrames - Number of animation frames to defer before rendering.
 * @returns The deferred collection component with fallback or children.
 *
 * @example
 * ```tsx
 * <DeferredCollection fallback={<LoadingState />}>
 *   {() => (
 *     <Virtualizer>
 *       <ListBox items={items}>
 *         {(item) => <ListBoxItem>{item.name}</ListBoxItem>}
 *       </ListBox>
 *     </Virtualizer>
 *   )}
 * </DeferredCollection>
 * ```
 */
declare function DeferredCollection({
  children,
  fallback,
  deferFrames
}: DeferredCollectionProps): react_jsx_runtime19.JSX.Element;
//#endregion
export { DeferredCollection, type DeferredCollectionProps };
//# sourceMappingURL=index.d.ts.map