@nivaro/react 0.1.262 → 0.1.263

package/dist/index.d.ts

@@ -960,6 +960,18 @@ export declare function ConformanceView({ className }: {
     className?: string;
 }): JSX.Element;
 
+/**
+ * `opts.open` is the gate's state AT CONSTRUCTION. A host that starts a
+ * hidden tab must pass `false` here rather than calling `setOpen(false)`
+ * from an effect: React runs children's effects before the parent's, so
+ * every react-query fetch under the provider has already fired by the time
+ * a parent effect closes the gate — the first paint of a hidden tab would
+ * still cost a full record load.
+ */
+export declare function createGatedClient(client: NivaroClient, opts?: {
+    open?: boolean;
+}): GatedClient;
+
 export declare function createLeaderSocket(key: string, cbs: LeaderCallbacks): LeaderSocketHandle;
 
 export declare function CronBuilder({ value, onChange, disabled }: {
@@ -1735,6 +1747,20 @@ export declare type FormVisibilityRule = {
     action: 'show' | 'hide';
 };
 
+export declare interface GatedClient extends NivaroClient {
+    /** Open = pass everything through; closed = queue reads. */
+    setOpen(open: boolean): void;
+    readonly open: boolean;
+    /**
+     * Release everything still queued and stop gating. Call from the host's
+     * unmount: react-query keeps an in-flight fetch alive after its observers
+     * leave, so a queued request that is never released is a query stuck
+     * "fetching" forever — a remount under the same keys dedupes onto it and
+     * shows skeletons until the page reloads.
+     */
+    dispose(): void;
+}
+
 /** The newer API build being served, or null while this tab is current. */
 export declare function getApiUpdate(): ApiVersionInfo | null;
 
@@ -4793,6 +4819,16 @@ declare interface UnsavedSummary {
     text: string;
 }
 
+/**
+ * `useAfterIdle(ms)` — false on mount, true once the browser has had `ms` of
+ * settle time after the first paint. Gate secondary reads on it (freshness
+ * stamps, cell provenance, lineage explainers, the live integrity check):
+ * they decorate a record the person is already looking at, and on a page
+ * that fans out a hundred reads at once they were competing for the same
+ * connection pool as the reads that PAINT the form.
+ */
+export declare function useAfterIdle(ms?: number): boolean;
+
 /**
  * Base URL + auth for the few raw `fetch` calls (widgets, PDF blobs) that
  * can't go through `client.request`. Derives everything from the ambient
@@ -5304,6 +5340,8 @@ declare interface WidgetSlotProps {
     onContentChange?: (hasContent: boolean) => void;
 }
 
+export declare function withGetCoalescing(client: NivaroClient): NivaroClient;
+
 export declare function WorkflowPanel({ collection, item }: {
     collection: string;
     item: string;