@altertable/data-app 0.61.0 → 0.63.0

package/dist/types/react/hooks.d.ts

@@ -1,11 +1,12 @@
 import { type ReactNode } from 'react';
 import type { DataOperations, DateRangeRequest } from '../core/contract.js';
-import type { DataClient, InputOf, OutputOf } from '../client/index.js';
+import type { DataClient } from '../client/data-client.js';
+import type { InputOf, OutputOf } from '../core/operation-types.js';
 import { type ReportingPeriod } from './ui/PeriodSummary.js';
 import { type VariableCollection } from '../core/variables.js';
 import { dateRangeVariable, type DateRangeVariableOptions } from './ui/variables.js';
 import { type DimensionFilterOptions, type DimensionOption, type DimensionValue } from '../core/dimension.js';
-import type { EmptyStateProps } from './ui/EmptyState.js';
+import type { EmptyContent } from './ui/presentation.js';
 import { type DataContentState } from './content.js';
 import { type DataViewDefinition, type ResolvedVariables, type ViewBindings } from './view.js';
 type TimeVariables<Additional extends VariableCollection> = {
@@ -41,7 +42,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
         data: undefined;
         error: Error;
@@ -69,7 +70,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
         data: undefined;
         error: null;
@@ -98,7 +99,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
         data: undefined;
         error: null;
@@ -125,9 +126,9 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         isError: false;
         error: null;
         isPending: false;
@@ -153,9 +154,9 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         error: Error;
         isError: true;
         isPending: false;
@@ -181,9 +182,9 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         error: null;
         isError: false;
         isPending: false;
@@ -220,7 +221,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
         data: undefined;
         error: Error;
@@ -236,8 +237,8 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         cancel(this: void): Promise<void>;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
@@ -257,7 +258,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
         data: undefined;
         error: null;
@@ -273,8 +274,8 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         cancel(this: void): Promise<void>;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
@@ -295,7 +296,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
         data: undefined;
         error: null;
@@ -310,8 +311,8 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         cancel(this: void): Promise<void>;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
@@ -331,9 +332,9 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         isError: false;
         error: null;
         isPending: false;
@@ -347,8 +348,8 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         cancel(this: void): Promise<void>;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
@@ -368,9 +369,9 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         error: Error;
         isError: true;
         isPending: false;
@@ -384,8 +385,8 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         cancel(this: void): Promise<void>;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
@@ -405,9 +406,9 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isRefetching: boolean;
         isStale: boolean;
         isEnabled: boolean;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         error: null;
         isError: false;
         isPending: false;
@@ -421,8 +422,8 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         cancel(this: void): Promise<void>;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
@@ -434,7 +435,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         input: (values: ResolvedVariables<Variables>) => InputOf<Operations[Name]>;
         bindings?: Partial<{ [Key in keyof Variables]: (input: InputOf<Operations[Name]>) => ResolvedVariables<Variables>[Key]; }> | undefined;
         isEmpty: (data: OutputOf<Operations[Name]>) => boolean;
-        empty: Pick<EmptyStateProps, 'title' | 'description'>;
+        empty: EmptyContent;
         date: import("./view.js").ViewDate<Variables, InputOf<Operations[Name]>>;
         variables: Variables;
         describeInput: (input: InputOf<Operations[Name]>) => string;
@@ -447,7 +448,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         input: (values: ResolvedVariables<Variables>) => InputOf<Operations[Name]>;
         bindings?: Partial<{ [Key in keyof Variables]: (input: InputOf<Operations[Name]>) => ResolvedVariables<Variables>[Key]; }> | undefined;
         isEmpty: (data: OutputOf<Operations[Name]>) => boolean;
-        empty: Pick<EmptyStateProps, 'title' | 'description'>;
+        empty: EmptyContent;
         date?: never;
         variables: Variables;
         describeInput: (input: InputOf<Operations[Name]>) => string;
@@ -466,7 +467,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
             period: ReturnType<typeof dateRangeVariable>;
         } & NoInfer<Additional>, InputOf<Operations[Name]>>;
         isEmpty: (data: OutputOf<Operations[Name]>) => boolean;
-        empty: Pick<EmptyStateProps, 'title' | 'description'>;
+        empty: EmptyContent;
     } & TimeInputMapping<NoInfer<Additional>, InputOf<Operations[Name]>>) => {
         operation: Name;
         input: (values: ResolvedVariables<{
@@ -476,7 +477,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
             period: import("../core/variables.js").DateRangeVariable;
         } & Additional extends infer T extends VariableCollection ? { [Key in keyof T]: (input: Input) => ResolvedVariables<T>[Key]; } : never> | undefined;
         isEmpty: (data: OutputOf<Operations[Name]>) => boolean;
-        empty: Pick<EmptyStateProps, 'title' | 'description'>;
+        empty: EmptyContent;
         date: import("./view.js").ViewDate<{
             period: import("../core/variables.js").DateRangeVariable;
         } & Additional, InputOf<Operations[Name]>>;
@@ -497,7 +498,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
             period: import("../core/variables.js").DateRangeVariable;
         } & Additional extends infer T extends VariableCollection ? { [Key in keyof T]: (input: Input) => ResolvedVariables<T>[Key]; } : never> | undefined;
         isEmpty: (data: OutputOf<Operations[Name]>) => boolean;
-        empty: Pick<EmptyStateProps, 'title' | 'description'>;
+        empty: EmptyContent;
         date?: never;
         variables: {
             period: import("../core/variables.js").DateRangeVariable;
@@ -541,17 +542,17 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         status: 'error';
         /** Abort the current request and restore its prior query state. */
         cancel(this: void): Promise<void>;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
             onCancel: (this: void) => Promise<void>;
         };
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
-        empty: Pick<EmptyStateProps, "description" | "title">;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
+        empty: EmptyContent;
         controls: ReactNode[] | null;
         variables: {
             values: import("../core/variables.js").AppVariableValues<Variables>;
@@ -593,17 +594,17 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         status: 'pending';
         /** Abort the current request and restore its prior query state. */
         cancel(this: void): Promise<void>;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
             onCancel: (this: void) => Promise<void>;
         };
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
-        empty: Pick<EmptyStateProps, "description" | "title">;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
+        empty: EmptyContent;
         controls: ReactNode[] | null;
         variables: {
             values: import("../core/variables.js").AppVariableValues<Variables>;
@@ -645,17 +646,17 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         status: 'pending';
         /** Abort the current request and restore its prior query state. */
         cancel(this: void): Promise<void>;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
             onCancel: (this: void) => Promise<void>;
         };
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
-        empty: Pick<EmptyStateProps, "description" | "title">;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
+        empty: EmptyContent;
         controls: ReactNode[] | null;
         variables: {
             values: import("../core/variables.js").AppVariableValues<Variables>;
@@ -685,7 +686,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isStale: boolean;
         isEnabled: boolean;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         isError: false;
         error: null;
         isPending: false;
@@ -697,17 +698,17 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         status: 'success';
         /** Abort the current request and restore its prior query state. */
         cancel(this: void): Promise<void>;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
             onCancel: (this: void) => Promise<void>;
         };
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
-        empty: Pick<EmptyStateProps, "description" | "title">;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
+        empty: EmptyContent;
         controls: ReactNode[] | null;
         variables: {
             values: import("../core/variables.js").AppVariableValues<Variables>;
@@ -737,7 +738,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isStale: boolean;
         isEnabled: boolean;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         error: Error;
         isError: true;
         isPending: false;
@@ -749,17 +750,17 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         status: 'error';
         /** Abort the current request and restore its prior query state. */
         cancel(this: void): Promise<void>;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
             onCancel: (this: void) => Promise<void>;
         };
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
-        empty: Pick<EmptyStateProps, "description" | "title">;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
+        empty: EmptyContent;
         controls: ReactNode[] | null;
         variables: {
             values: import("../core/variables.js").AppVariableValues<Variables>;
@@ -789,7 +790,7 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         isStale: boolean;
         isEnabled: boolean;
         fetchStatus: import("@tanstack/react-query").FetchStatus;
-        data: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
+        data: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         error: null;
         isError: false;
         isPending: false;
@@ -801,17 +802,17 @@ export declare function createDataHooks<Operations extends DataOperations>(clien
         status: 'success';
         /** Abort the current request and restore its prior query state. */
         cancel(this: void): Promise<void>;
-        response: import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
+        response: import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
         view: import("../core/data-view.js").DataView<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>;
         snapshot: import("../core/data-view.js").DisplayedSnapshot<OutputOf<Operations[Name]>, InputOf<Operations[Name]>> | undefined;
-        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/index.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
+        refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("../client/data-client.js").DataResponse<OutputOf<Operations[Name]>, InputOf<Operations[Name]>>, Error>>;
         refresh: {
             refreshing: boolean;
             onRefresh(): undefined;
             onCancel: (this: void) => Promise<void>;
         };
-        queries: import("../core/contract.js").DisclosedQuery[] | undefined;
-        empty: Pick<EmptyStateProps, "description" | "title">;
+        queries: import("../core/operation-types.js").DisclosedQuery[] | undefined;
+        empty: EmptyContent;
         controls: ReactNode[] | null;
         variables: {
             values: import("../core/variables.js").AppVariableValues<Variables>;

package/dist/types/react/index.d.ts

@@ -1,11 +1,144 @@
 /**
- * React bindings and UI; load the stylesheet separately in the browser entry.
+ * React bindings and UI; inject styles explicitly in the browser entry.
  * @module @altertable/data-app/react
  * @see https://github.com/altertable-ai/data-app/blob/main/docs/react.md
  */
+export { injectDataAppStyles } from './styles.js';
+export { injectDataAppShellStyles } from './shellStyles.js';
+export type { DataAppStylesOptions } from './styles.js';
 export { mountDataApp, DataAppProvider } from './mount.js';
 export { createDataHooks } from './hooks.js';
 export { defineDataContent } from './content.js';
 export type { DataContentState } from './content.js';
 export type { DataViewDefinition, ResolvedVariables, ViewBindings, } from './view.js';
-export * from './ui/index.js';
+export { DataApp } from './ui/DataApp.js';
+export type { DataAppProps, DataAppRequest } from './ui/DataApp.js';
+export { GettingStarted } from './ui/GettingStarted.js';
+export { AppLayout } from './ui/AppLayout.js';
+export type { AppLayoutProps } from './ui/AppLayout.js';
+export { AppHeader } from './ui/AppHeader.js';
+export type { AppHeaderProps } from './ui/AppHeader.js';
+export { AppScope } from './ui/AppScope.js';
+export type { AppScopeProps } from './ui/AppScope.js';
+export { AppToolbar } from './ui/AppToolbar.js';
+export type { AppToolbarProps } from './ui/AppToolbar.js';
+export { VariableBar } from './ui/VariableBar.js';
+export type { VariableBarProps } from './ui/VariableBar.js';
+export { AppFooter } from './ui/AppFooter.js';
+export type { AppFooterProps } from './ui/AppFooter.js';
+export { ThemeSelector, ThemeToggle } from './ui/ThemeSelector.js';
+export type { ThemeSelectorProps } from './ui/ThemeSelector.js';
+export { Stack } from './ui/Stack.js';
+export type { StackProps } from './ui/Stack.js';
+export { Grid } from './ui/Grid.js';
+export type { GridProps } from './ui/Grid.js';
+export { GridItem } from './ui/GridItem.js';
+export type { GridItemProps } from './ui/GridItem.js';
+export type { WidgetEvidence } from './ui/WidgetEvidence.js';
+export { DataWidget } from './ui/DataWidget.js';
+export type { WidgetStatus } from './ui/RequestHint.js';
+export type { DataWidgetProps } from './ui/DataWidget.js';
+export { TextContent } from './ui/TextContent.js';
+export type { TextContentProps } from './ui/TextContent.js';
+export { TextWidget } from './ui/TextWidget.js';
+export type { TextWidgetProps } from './ui/TextWidget.js';
+export { VisualizationWidget } from './ui/VisualizationWidget.js';
+export type { VisualizationWidgetProps, VisualizationWidgetView, } from './ui/VisualizationWidget.js';
+export { TableWidget } from './ui/TableWidget.js';
+export type { TableWidgetColumn, TableWidgetProps, TableWidgetSearch, } from './ui/TableWidget.js';
+export { chartColor } from './ui/chartColor.js';
+export { Breakdown } from './ui/Breakdown.js';
+export type { BreakdownItem, BreakdownProps } from './ui/Breakdown.js';
+export { Ranking } from './ui/Ranking.js';
+export type { RankingItem, RankingProps } from './ui/Ranking.js';
+export { WidgetDisclosure } from './ui/WidgetDisclosure.js';
+export type { WidgetDisclosureProps } from './ui/WidgetDisclosure.js';
+export { WidgetViewTabs } from './ui/WidgetViewTabs.js';
+export type { WidgetView, WidgetViewTabsProps, } from './ui/WidgetViewTabs.js';
+export { ComparisonVisual } from './ui/ComparisonVisual.js';
+export type { ComparisonVisualProps } from './ui/ComparisonVisual.js';
+export { calendarMetricComparison } from './ui/comparison.js';
+export type { MetricComparison } from './ui/comparison.js';
+export { DataTable, DataTableEmptyRow, DataTableTimestamp, DataTableShare, } from './ui/DataTable.js';
+export type { DataTableProps, DataTableSearch, DataTableEmptyRowProps, DataTableTimestampProps, } from './ui/DataTable.js';
+export { MetricWidget } from './ui/MetricWidget.js';
+export type { MetricWidgetProps } from './ui/MetricWidget.js';
+export { SelectableBarChart } from './ui/SelectableBarChart.js';
+export type { SelectableBarChartProps, SelectableBarItem, } from './ui/SelectableBarChart.js';
+export { DimensionPicker } from './ui/DimensionPicker.js';
+export { EmptyState } from './ui/EmptyState.js';
+export type { EmptyStateProps } from './ui/EmptyState.js';
+export { Skeleton } from './ui/Skeleton.js';
+export type { SkeletonProps } from './ui/Skeleton.js';
+export { DataAppSkeleton } from './ui/DataAppSkeleton.js';
+export type { DataAppSkeletonProps } from './ui/DataAppSkeleton.js';
+export { DataBoundary } from './ui/DataBoundary.js';
+export { resolveDataView } from '../core/data-view.js';
+export { displayedSnapshot } from '../core/data-view.js';
+export type { DataView, DataSnapshot, DisplayedSnapshot, } from '../core/data-view.js';
+export type { DataBoundaryProps } from './ui/DataBoundary.js';
+export { RefreshRegion } from './ui/RefreshRegion.js';
+export type { RefreshRegionProps } from './ui/RefreshRegion.js';
+export { DataSection } from './ui/DataSection.js';
+export type { DataSectionProps, SectionResult, } from './ui/DataSection.js';
+export { StatusPanel } from './ui/StatusPanel.js';
+export type { StatusPanelProps } from './ui/StatusPanel.js';
+export { ContentSkeleton } from './ui/ContentSkeleton.js';
+export type { ContentSkeletonProps } from './ui/ContentSkeleton.js';
+export { DataViewToast } from './ui/DataViewToast.js';
+export type { DataViewToastProps } from './ui/DataViewToast.js';
+export { UpdatedAt } from './ui/UpdatedAt.js';
+export type { UpdatedAtProps } from './ui/UpdatedAt.js';
+export { DateTimeTooltip } from './ui/DateTimeTooltip.js';
+export type { DateTimeTooltipProps } from './ui/DateTimeTooltip.js';
+export { LiveControl } from './ui/LiveControl.js';
+export type { LiveControlProps, LiveIntervalSeconds, } from './ui/LiveControl.js';
+export { DateRangePicker } from './ui/DateRangePicker.js';
+export type { DatePresetId, DateRange, DateRangePickerProps, } from './ui/DateRangePicker.js';
+export { defineAppVariables, textVariable, selectVariable, dateRangeVariable, dateRangeControl, useAppVariables, } from './ui/variables.js';
+export type { AppVariable, AppVariableValues, DateRangeSelection, DateRangeVariable, DateRangeVariableOptions, } from './ui/variables.js';
+export { PeriodSummary } from './ui/PeriodSummary.js';
+export type { ReportingPeriod, PeriodComparison, PeriodSummaryProps, } from './ui/PeriodSummary.js';
+export { SearchField } from './ui/SearchField.js';
+export type { SearchFieldProps } from './ui/SearchField.js';
+export { searchItems } from './ui/searchItems.js';
+export type { SearchAttribute, SearchHit, SearchItemsOptions, SearchMatchValue, SearchRange, } from './ui/searchItems.js';
+export { SearchMatch } from './ui/SearchMatch.js';
+export type { SearchMatchProps } from './ui/SearchMatch.js';
+export { Combobox } from './ui/Combobox.js';
+export type { ComboboxOption, ComboboxProps } from './ui/Combobox.js';
+export { GradientScroll } from './ui/GradientScroll.js';
+export type { GradientScrollProps } from './ui/GradientScroll.js';
+export { searchParams, subscribeSearch, writeSearch, } from './ui/search.js';
+export { Tabs, TabList, Tab, TabPanels, TabPanel, useViewTab, } from './ui/Tabs.js';
+export { createDataContext, defineDataContext, evidenceFor, } from './ui/data-context.js';
+export type { DataContext, GlossaryEntry } from './ui/data-context.js';
+export { defineDataIdentifiers } from './ui/data-identifiers.js';
+export type { DataIdentifierDefinition, TableIdentifier, ColumnIdentifier, } from './ui/data-identifiers.js';
+export { GlossaryExplanation } from './ui/GlossaryExplanation.js';
+export type { GlossaryExplanationProps } from './ui/GlossaryExplanation.js';
+export { GlossaryDefinition } from './ui/GlossaryDefinition.js';
+export type { GlossaryDefinitionProps } from './ui/GlossaryDefinition.js';
+export { AboutData } from './ui/AboutData.js';
+export type { AboutDataProps, AboutEmpty, AboutSubject, AboutTab, } from './ui/AboutData.js';
+export { PresentStory } from './ui/PresentStory.js';
+export type { PresentStoryProps } from './ui/PresentStory.js';
+export type { StoryFinding, BoundStory } from './ui/story.js';
+export { Checkbox } from './ui/Checkbox.js';
+export type { CheckboxProps } from './ui/Checkbox.js';
+export { AppIcon } from './ui/icons.js';
+export type { AppIconName, AppIconProps } from './ui/icons.js';
+export { IconButton } from './ui/IconButton.js';
+export type { IconButtonProps } from './ui/IconButton.js';
+export { Kbd } from './ui/Kbd.js';
+export type { KbdProps } from './ui/Kbd.js';
+export { Sheet } from './ui/Sheet.js';
+export type { SheetDialogProps, SheetProps } from './ui/Sheet.js';
+export { Tooltip, TooltipProvider } from './ui/Tooltip.js';
+export type { TooltipProps, TooltipProviderProps, } from './ui/Tooltip.js';
+export { Button } from './ui/Button.js';
+export type { ButtonProps } from './ui/Button.js';
+export { HelpPopover } from './ui/HelpPopover.js';
+export type { HelpPopoverPanelProps, HelpPopoverProps, HelpPopoverTriggerProps, } from './ui/HelpPopover.js';
+export type { MetricDefinition } from './ui/metric.js';
+export type { DataReading, MetricReading, MetricValues, } from '../core/reading.js';

package/dist/types/react/injectStyles.d.ts

@@ -0,0 +1,7 @@
+import type { DataAppStylesOptions } from './styles.js';
+export declare function injectStyles({ name, attribute, css, options, }: {
+    name: string;
+    attribute: string;
+    css: string;
+    options: DataAppStylesOptions;
+}): HTMLStyleElement;

package/dist/types/react/shellStyles.d.ts

@@ -0,0 +1,3 @@
+import type { DataAppStylesOptions } from './styles.js';
+/** Install shared layout, widget surface, and skeleton styles once per document, before mounting. */
+export declare function injectDataAppShellStyles(options?: DataAppStylesOptions): HTMLStyleElement;

package/dist/types/react/styles.d.ts

@@ -0,0 +1,8 @@
+export interface DataAppStylesOptions {
+    /** Defaults to the current browser document. */
+    document?: Document;
+    /** Nonce permitted by the document's style-src CSP. */
+    nonce?: string;
+}
+/** Install the complete UI stylesheet once per document, before mounting. */
+export declare function injectDataAppStyles(options?: DataAppStylesOptions): HTMLStyleElement;

package/dist/types/react/ui/AboutData.d.ts

@@ -3,7 +3,6 @@ import type { DisclosedQuery } from '../../core/contract.js';
 import type { DataContext, GlossaryEntry } from './data-context.js';
 import { type ButtonProps } from './Button.js';
 import { type SheetDialogProps } from './Sheet.js';
-
 export type AboutTab = 'glossary' | 'queries';
 export type AboutEmpty = {
     glossary: {

package/dist/types/react/ui/AppFooter.d.ts

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type AppFooterProps = ComponentPropsWithRef<'footer'> & {
     attribution?: ReactNode;
 };

package/dist/types/react/ui/AppHeader.d.ts

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type AppHeaderProps = {
     scope?: ReactNode;
     title: ReactNode;

package/dist/types/react/ui/AppLayout.d.ts

@@ -1,7 +1,6 @@
 import type { ComponentProps, ComponentPropsWithRef, ReactNode } from 'react';
 import { AppFooter } from './AppFooter.js';
 import { type TooltipProviderProps } from './Tooltip.js';
-
 export type AppLayoutProps = {
     children: ReactNode;
     footerActions?: ReactNode;