chore: checkbox async propagation docs

Author: lukasbach

packages/core/src/mddocs-entry.ts

@@ -10,6 +10,7 @@ import { SyncDataLoaderFeatureDef } from "./features/sync-data-loader/types";
 import { TreeFeatureDef } from "./features/tree/types";
 import { PropMemoizationFeatureDef } from "./features/prop-memoization/types";
 import { KeyboardDragAndDropFeatureDef } from "./features/keyboard-drag-and-drop/types";
+import type { CheckboxesFeatureDef } from "./features/checkboxes/types";
 
 export * from ".";
 
@@ -167,3 +168,15 @@ export type TreeFeatureTreeInstance<T> = TreeFeatureDef<T>["treeInstance"];
 /** @interface */
 export type TreeFeatureItemInstance<T> = TreeFeatureDef<T>["itemInstance"];
 export type TreeFeatureHotkeys<T> = TreeFeatureDef<T>["hotkeys"];
+
+/** @interface */
+export type CheckboxesFeatureConfig<T> = CheckboxesFeatureDef<T>["config"];
+/** @interface */
+export type CheckboxesFeatureState<T> = CheckboxesFeatureDef<T>["state"];
+/** @interface */
+export type CheckboxesFeatureTreeInstance<T> =
+  CheckboxesFeatureDef<T>["treeInstance"];
+/** @interface */
+export type CheckboxesFeatureItemInstance<T> =
+  CheckboxesFeatureDef<T>["itemInstance"];
+export type CheckboxesFeatureHotkeys<T> = CheckboxesFeatureDef<T>["hotkeys"];

packages/docs/docs/2-features/10-checkboxes.mdx

@@ -38,17 +38,24 @@ always be directly inferred from their leafs.
 
 :::warning
 
-Trees with `propagateCheckedState=true` is currently only supported for synchronous trees, not trees using the Async
-Data Loader feature.
+If you use asynchronous trees with `propagateCheckedState=true`, checking an item will trigger loading
+children recursively for all descendants.
 
 :::
 
-The default for `propagateCheckedState` is `true` for synchronous trees, and `false` for asynchronous trees.
-
 Below, you can experiment with the behavior for various combinations of `propagateCheckedState` and `canCheckFolders`:
 
 <DemoBox tags={["feature/checkbox"]} initialStory="react-checkboxes-configurability--configurability" />
 
+## Asynchronous checkbox propagation
+
+You can also use checkbox propagation with trees that use async data loaders. If a checkbox is clicked, all nested
+descendants IDs that are not yet loaded will be loaded via the `getChildren` or `getChildrenWithData` APIs, and
+their checkbox state will be updated accordingly. While they are loading, the state variable `loadingCheckPropagationItems`
+can be used to render a loading spinner on checkboxes that are loading.
+
+<DemoBox tags={["feature/checkbox"]} initialStory="react-checkboxes-async-configurability--async-configurability" />
+
 ## Further customizing checkbox behavior
 
 Similar to other Headless Tree features, you can customize feature behavior by overwriting any of the publicly