@altertable/data-app 0.61.0 → 0.63.0

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type AppScopeProps = {
     organization: string;
     environment: string;

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

@@ -3,7 +3,6 @@ import type { DataView } from '../../core/data-view.js';
 import { type LiveControlProps } from './LiveControl.js';
 import { PresentStory } from './PresentStory.js';
 import { RefreshControl } from './RefreshControl.js';
-
 export type AppToolbarProps = {
     children?: ReactNode;
     end?: ReactNode;

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type BreakdownItem = {
     id: string;
     label: ReactNode;

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

@@ -1,6 +1,5 @@
 import type { ComponentPropsWithRef } from 'react';
 import { type ButtonProps as AriaButtonProps } from 'react-aria-components';
-
 export type ButtonProps = ComponentPropsWithRef<'button'> & {
     variant?: 'elevated' | 'outline' | 'ghost';
     size?: 'default' | 'compact' | 'icon' | 'icon-compact';

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

@@ -1,5 +1,4 @@
 import { type ReactNode } from 'react';
-
 export type CheckboxProps = {
     label: string;
     description?: ReactNode;

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

@@ -1,4 +1,3 @@
-
 /** IDs are nonempty and unique across ordinary and missing options. */
 export type ComboboxOption = {
     id: string;

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

@@ -1,7 +1,6 @@
 import { type MetricComparison } from './comparison.js';
 import type { MetricDefinition } from './metric.js';
 import type { MetricReading } from '../../core/reading.js';
-
 type UnboundComparisonProps = MetricComparison & {
     label: string;
     emphasis?: 'standard' | 'story';

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

@@ -1,8 +1,5 @@
 import type { ComponentPropsWithRef } from 'react';
-
-export type ContentSkeletonProps = {
-    rows?: number;
-    variant: 'metric' | 'panel' | 'ranking';
-} & Omit<ComponentPropsWithRef<'div'>, 'children'>;
+import type { SkeletonContent } from './presentation.js';
+export type ContentSkeletonProps = SkeletonContent & Omit<ComponentPropsWithRef<'div'>, 'children'>;
 /** A metric, panel, or ranking placeholder to compose in the same layout as live content. */
 export declare function ContentSkeleton({ variant, rows, className, ...props }: ContentSkeletonProps): import("react").JSX.Element;

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

@@ -7,7 +7,7 @@ import { type AppToolbarProps } from './AppToolbar.js';
 import type { DataContext } from './data-context.js';
 import type { BoundStory } from './story.js';
 import { type SectionResult } from './DataSection.js';
-import type { EmptyStateProps } from './EmptyState.js';
+import type { EmptyContent } from './presentation.js';
 type DataAppBaseProps = {
     config: DataAppConfig;
     dataContext: DataContext;
@@ -25,7 +25,7 @@ type DataAppBaseProps = {
 export type DataAppRequest<Data, Input> = SectionResult<Data, Input> & {
     queries?: DisclosedQuery[];
     refresh?: AppToolbarProps['refresh'];
-    empty: Pick<EmptyStateProps, 'title' | 'description'>;
+    empty: EmptyContent;
     controls?: ReactNode;
 };
 export type DataAppProps<Data = unknown, Input = unknown> = DataAppBaseProps & ({

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

@@ -0,0 +1,7 @@
+import type { ComponentPropsWithRef, ReactNode } from 'react';
+export type DataAppSkeletonProps = Omit<ComponentPropsWithRef<'output'>, 'children' | 'role' | 'aria-busy'> & {
+    header?: ReactNode;
+    footer?: ReactNode;
+};
+/** Host-side placeholder while a data app starts. Header and footer slots remain host-owned; widget placeholders are decorative. */
+export declare function DataAppSkeleton({ header, footer, className, ...props }: DataAppSkeletonProps): import("react").JSX.Element;

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 import type { DataView } from '../../core/data-view.js';
 export type DataBoundaryProps<T, Input = unknown> = {
     view: DataView<T, Input>;

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

@@ -1,14 +1,13 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
 import type { DataView } from '../../core/data-view.js';
-import { type EmptyStateProps } from './EmptyState.js';
-type SectionEmpty = Pick<EmptyStateProps, 'title' | 'description'>;
+import type { EmptyContent } from './presentation.js';
 export type SectionResult<Data, Input> = {
     view: DataView<Data, Input>;
     refetch: () => unknown;
 };
 export type DataSectionProps<Data, Input = unknown> = {
     result: SectionResult<Data, Input>;
-    empty: SectionEmpty;
+    empty: EmptyContent;
     children: (data: Data, displayedInput: Input) => ReactNode;
     /** Placeholder layout for an initial request; use the ready view's grid without copied values. */
     loading?: ReactNode;
@@ -25,4 +24,3 @@ export type DataSectionProps<Data, Input = unknown> = {
 /** One request boundary for any number of cards. `DataBoundary` exposes the lower-level
  * view-state slots for custom composition. */
 export declare function DataSection<Data, Input>({ result, children, empty, loading, error, label, notice, dimOnUpdate, ...props }: DataSectionProps<Data, Input>): import("react").JSX.Element;
-export {};

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

@@ -1,7 +1,6 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-import { type EmptyStateProps } from './EmptyState.js';
+import type { EmptyContent } from './presentation.js';
 import { type SearchFieldProps } from './SearchField.js';
-
 export type DataTableSearch = Pick<SearchFieldProps, 'label' | 'placeholder' | 'value' | 'onChange' | 'resetValue'> & {
     /** Number of available records before filtering or a display limit. */
     itemCount: number;
@@ -16,7 +15,7 @@ export declare function DataTable({ className, ref, searchable, ...props }: Data
 export declare function DataTableShare({ value }: {
     value: number;
 }): import("react").JSX.Element;
-export type DataTableEmptyRowProps = Pick<EmptyStateProps, 'title' | 'description'> & {
+export type DataTableEmptyRowProps = EmptyContent & {
     colSpan: number;
 };
 export declare function DataTableEmptyRow({ colSpan, title, description, }: DataTableEmptyRowProps): import("react").JSX.Element;

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

@@ -1,6 +1,5 @@
 import { type ReactNode } from 'react';
 import type { DataView } from '../../core/data-view.js';
-
 export type DataViewToastProps<Data, Input> = {
     view: DataView<Data, Input>;
     message?: ReactNode;

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

@@ -1,12 +1,7 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
-import type { DataReading } from '../../core/reading.js';
 import { type WidgetStatus } from './RequestHint.js';
-import { type ContentSkeletonProps } from './ContentSkeleton.js';
-import { type EmptyStateProps } from './EmptyState.js';
+import type { EmptyContent, BoundWidgetReading } from './presentation.js';
 import type { WidgetEvidence } from './WidgetEvidence.js';
-
-
-type Empty = Pick<EmptyStateProps, 'title' | 'description'>;
 type DataWidgetBaseProps = {
     title: ReactNode;
     count?: number;
@@ -21,18 +16,13 @@ type DataWidgetBaseProps = {
 /** Owns loading, empty content, actions, and inspection. Page and sheet mount the same
  * body and footer; hold interactive child state above the widget to share it across mounts.
  * A bound reading requires evidence; its child renderer runs only for nonempty ready data. */
-export type DataWidgetProps<Data = unknown> = DataWidgetBaseProps & ({
-    reading: DataReading<Data>;
-    isEmpty: (data: Data) => boolean;
-    empty: Empty;
-    evidence: WidgetEvidence;
-    skeleton?: Pick<ContentSkeletonProps, 'variant' | 'rows'>;
+export type DataWidgetProps<Data = unknown> = DataWidgetBaseProps & ((BoundWidgetReading<Data> & {
     children: (data: Data) => ReactNode;
-} | {
+}) | {
     reading?: never;
     isEmpty?: never;
     skeleton?: never;
-    empty?: Empty;
+    empty?: EmptyContent;
     children: ReactNode;
 });
 export declare function DataWidget<Data>(props: DataWidgetProps<Data>): import("react").JSX.Element;

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

@@ -1,7 +1,6 @@
 import { type ComponentProps, type ReactNode } from 'react';
 import { type CalendarDate } from '@internationalized/date';
 import { DateRangePicker as AriaDateRangePicker } from 'react-aria-components';
-
 import { type DatePresetId, type DateRange } from '../../core/date-range.js';
 export type { DatePresetId, DateRange } from '../../core/date-range.js';
 export type DateRangePickerProps = {

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

@@ -1,6 +1,5 @@
 import { type ReactNode } from 'react';
 import { type HelpPopoverProps } from './HelpPopover.js';
-
 export type DateTimeTooltipProps = {
     date: Date;
     timeZone?: string;

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

@@ -1,8 +1,5 @@
-import type { ReactNode } from 'react';
-
-export type EmptyStateProps = {
-    title: ReactNode;
-    description?: ReactNode;
+import type { EmptyContent } from './presentation.js';
+export type EmptyStateProps = EmptyContent & {
     variant?: 'visual' | 'table';
     className?: string;
 };

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

@@ -1,6 +1,5 @@
 import type { DataAppConfig } from '../../core/config.js';
 import type { DataContext } from './data-context.js';
-
 /** Query-backed connection state and next steps for a newly created app. Mount within
  * `DataAppProvider` and register `connection: connectionCheck()` on the server. */
 export declare function GettingStarted({ config, dataContext, }: {

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

@@ -1,6 +1,5 @@
 import type { ReactNode } from 'react';
 import type { GlossaryEntry } from './data-context.js';
-
 export type GlossaryDefinitionProps = {
     entry: GlossaryEntry;
     children?: ReactNode;

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

@@ -2,7 +2,6 @@ import type { ComponentPropsWithRef, ReactNode } from 'react';
 import type { DisclosedQuery } from '../../core/contract.js';
 import type { DataContext, GlossaryEntry } from './data-context.js';
 import { type AboutEmpty } from './AboutData.js';
-
 export type GlossaryExplanationProps = {
     entry: GlossaryEntry;
     empty?: AboutEmpty;

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

@@ -1,5 +1,4 @@
 import { type ComponentPropsWithRef } from 'react';
-
 export type GradientScrollProps = ComponentPropsWithRef<'div'> & {
     axis?: 'vertical' | 'horizontal';
     /** Disable the start fade when sticky controls share the scrollport. */

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type GridProps = {
     children: ReactNode;
     /** Maximum columns; cards wrap sooner when the container cannot fit their minimum width. */

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

@@ -1,7 +1,5 @@
 import { type ComponentPropsWithRef, type ReactNode, type RefObject } from 'react';
 import { type Placement } from '@floating-ui/react';
-
-
 export type HelpPopoverTriggerProps = Omit<ComponentPropsWithRef<'button'>, 'children' | 'type'>;
 export type HelpPopoverPanelProps = Omit<ComponentPropsWithRef<'section'>, 'children' | 'role'>;
 export type HelpPopoverProps = {

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

@@ -1,6 +1,5 @@
 import type { ComponentPropsWithRef } from 'react';
 import { type Shortcut } from './shortcuts.js';
-
 export type KbdProps = ComponentPropsWithRef<'kbd'> & {
     shortcut?: Shortcut;
 };

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef } from 'react';
-
 export type LiveIntervalSeconds = 30 | 60 | 300;
 export type LiveControlProps = {
     enabled: boolean;

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

@@ -5,8 +5,6 @@ import { type MetricComparison } from './comparison.js';
 import { type MetricFormat } from '../../core/format.js';
 import type { MetricReading } from '../../core/reading.js';
 import { type MetricDefinition } from './metric.js';
-
-
 type MetricWidgetBaseProps = {
     label: string;
     description?: ReactNode;

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

@@ -1,5 +1,4 @@
 import type { ReportingPeriod } from '../../core/contract.js';
-
 export type { ReportingPeriod } from '../../core/contract.js';
 export type PeriodComparison = {
     kind: 'previous';

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

@@ -3,7 +3,6 @@ import type { ThemeController } from '../../core/appearance.js';
 import { type AboutEmpty } from './AboutData.js';
 import type { DataContext } from './data-context.js';
 import { type StoryFinding } from './story.js';
-
 export type StoryStep = {
     id: string;
     empty?: AboutEmpty;

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

@@ -1,6 +1,5 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
 import type { DisclosedQuery } from '../../core/contract.js';
-
 export type QueryListProps = {
     queries?: DisclosedQuery[];
     names?: string[];

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type RankingItem = {
     id: string;
     label: ReactNode;

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

@@ -1,5 +1,4 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
-
 export type RefreshControlProps = {
     refreshing: boolean;
     children: ReactNode;

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type RefreshRegionProps = {
     refreshing: boolean;
     dimOnUpdate?: boolean;

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

@@ -1,4 +1,3 @@
-
 /** Idle keeps the same reserved space as refresh and failure. Initial loading belongs to skeletons. */
 export type WidgetStatus = {
     kind: 'idle';

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

@@ -1,5 +1,4 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
-
 export type SearchFieldProps = {
     label: string;
     value: string;

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

@@ -1,7 +1,6 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 /** One search control surface for picker search and table/page search. */
-export declare function SearchInput({ size, endAction, loading, className, ...props }: Omit<ComponentPropsWithRef<'input'>, 'size' | 'children'> & {
+export declare function SearchInput({ size, endAction, loading, className, onKeyDown, ...props }: Omit<ComponentPropsWithRef<'input'>, 'size' | 'children'> & {
     size?: 'default' | 'compact';
     endAction?: ReactNode;
     /** Replaces the search glyph in its existing space; input and results remain usable. */

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

@@ -1,6 +1,5 @@
 import type { ComponentPropsWithRef } from 'react';
 import type { SearchMatchValue } from './searchItems.js';
-
 export type SearchMatchProps = {
     match: SearchMatchValue;
 } & Omit<ComponentPropsWithRef<'span'>, 'children'>;

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

@@ -1,4 +1,3 @@
-
 export type SelectableBarItem = {
     id: string;
     label: string;

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

@@ -1,4 +1,3 @@
-
 /** Decorative selection indicator; the containing control owns its accessible semantics. */
 export declare function SelectionMark({ selected }: {
     selected: boolean;

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

@@ -1,5 +1,4 @@
 import { type ComponentPropsWithRef, type ReactNode, type RefObject } from 'react';
-
 export type SheetDialogProps = Omit<ComponentPropsWithRef<'dialog'>, 'children' | 'open' | 'title' | 'aria-labelledby'>;
 export type SheetProps = {
     open: boolean;

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef } from 'react';
-
 export type SkeletonProps = Omit<ComponentPropsWithRef<'span'>, 'children' | 'aria-hidden'>;
 /** Decorative loading placeholder that fades in only when loading takes a moment.
  * Put the accessible status on its container. */

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type StackProps = {
     children: ReactNode;
     gap?: 'sm' | 'md' | 'lg';

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type StatusPanelProps = {
     status: 'loading' | 'empty' | 'error';
     title: ReactNode;

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

@@ -2,10 +2,9 @@ import { type ComponentPropsWithRef, type ReactNode } from 'react';
 import type { WidgetEvidence } from './WidgetEvidence.js';
 import type { WidgetStatus } from './RequestHint.js';
 import { type DataTableSearch } from './DataTable.js';
-import type { EmptyStateProps } from './EmptyState.js';
+import type { EmptyContent } from './presentation.js';
 import { type SearchHit, type SearchItemsOptions } from './searchItems.js';
 import type { DataReading } from '../../core/reading.js';
-
 export type TableWidgetColumn<Row> = {
     /** Stable, nonempty identity; unique within this table. */
     id: string;
@@ -28,7 +27,7 @@ type TableWidgetBaseProps<Row> = {
     evidence?: WidgetEvidence;
     search?: TableWidgetSearch<Row>;
     /** Valid result with no rows; the header remains visible. */
-    empty: Pick<EmptyStateProps, 'title' | 'description'>;
+    empty: EmptyContent;
 } & ({
     /** Positive integer preview cap after search; disables pagination. */
     limit: number;

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

@@ -1,5 +1,4 @@
 import { Tabs, TabList, Tab, TabPanels, TabPanel } from 'react-aria-components/Tabs';
-
 /** React Aria tabs with keyboard and ARIA behavior; pair each Tab and TabPanel by stable id. */
 export { Tabs, TabList, Tab, TabPanels, TabPanel };
 /** Keep a page-level tab in `?view=`; reserve `?tab=` for the inspect sheet. */

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

@@ -0,0 +1,4 @@
+import type { ComponentPropsWithRef } from 'react';
+export type TextContentProps = ComponentPropsWithRef<'div'>;
+/** Prose typography for page introductions, widget bodies, and inspection content. */
+export declare function TextContent({ className, ...props }: TextContentProps): import("react").JSX.Element;

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

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { DataReading } from '../../core/reading.js';
+import { type DataWidgetProps } from './DataWidget.js';
+import type { WidgetEvidence } from './WidgetEvidence.js';
+type TextWidgetBaseProps = Omit<Extract<DataWidgetProps, {
+    reading?: never;
+}>, 'reading' | 'children' | 'isEmpty' | 'empty' | 'skeleton' | 'bodyPadding'>;
+/** Framed narrative context. Bind claims and scope to the same displayed reading.
+ * The renderer handles every ready value, including zero and empty collections. */
+export type TextWidgetProps<Data = unknown> = TextWidgetBaseProps & ({
+    reading: DataReading<Data>;
+    evidence: WidgetEvidence;
+    children: (data: Data) => ReactNode;
+} | {
+    reading?: never;
+    children: ReactNode;
+});
+export declare function TextWidget<Data>(props: TextWidgetProps<Data>): import("react").JSX.Element;
+export {};

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

@@ -1,6 +1,5 @@
 import { type ComponentPropsWithRef, type ReactNode, type RefObject } from 'react';
 import type { ThemeController } from '../../core/appearance.js';
-
 export type ThemeSelectorProps = {
     theme: ThemeController;
     children?: ReactNode;

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

@@ -1,5 +1,4 @@
 import { type ComponentPropsWithRef, type ReactNode, type RefObject } from 'react';
-
 export type TooltipProviderProps = {
     children: ReactNode;
     delay?: number;

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

@@ -1,6 +1,5 @@
 import { type ReactNode } from 'react';
 import { type DateTimeTooltipProps } from './DateTimeTooltip.js';
-
 export type UpdatedAtProps = {
     timestamp: number;
     locale?: string;

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type VariableBarProps = {
     children: ReactNode;
 } & Omit<ComponentPropsWithRef<'div'>, 'children'>;

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

@@ -1,18 +1,15 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
 import type { WidgetEvidence } from './WidgetEvidence.js';
-import { type DataWidgetProps } from './DataWidget.js';
-import type { EmptyStateProps } from './EmptyState.js';
-import type { DataReading } from '../../core/reading.js';
-import { type ContentSkeletonProps } from './ContentSkeleton.js';
-
+import type { WidgetStatus } from './RequestHint.js';
+import type { EmptyContent, BoundWidgetReading } from './presentation.js';
 type VisualizationWidgetBaseProps = {
     title: ReactNode;
     description?: ReactNode;
     insight?: ReactNode;
     action?: ReactNode;
     evidence?: WidgetEvidence;
-    status?: DataWidgetProps['status'];
-    empty?: Pick<EmptyStateProps, 'title' | 'description'>;
+    status?: WidgetStatus;
+    empty?: EmptyContent;
 } & Omit<ComponentPropsWithRef<'section'>, 'about' | 'title' | 'children'>;
 type UnboundVisualizationWidgetProps = VisualizationWidgetBaseProps & ({
     loading: true;
@@ -27,12 +24,7 @@ export type VisualizationWidgetView<Data> = {
     label: ReactNode;
     render: (data: Data) => ReactNode;
 };
-type BoundVisualizationWidgetBase<Data> = VisualizationWidgetBaseProps & {
-    evidence: WidgetEvidence;
-    reading: DataReading<Data>;
-    isEmpty: (data: Data) => boolean;
-    empty: Pick<EmptyStateProps, 'title' | 'description'>;
-    skeleton?: Pick<ContentSkeletonProps, 'variant' | 'rows'>;
+type BoundVisualizationWidgetBase<Data> = VisualizationWidgetBaseProps & BoundWidgetReading<Data> & {
     visual?: never;
     loading?: never;
 };

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

@@ -1,5 +1,4 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-
 export type WidgetDisclosureProps = {
     label: ReactNode;
     children: ReactNode;

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

@@ -1,11 +1,10 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-import { type EmptyStateProps } from './EmptyState.js';
-
+import type { EmptyContent } from './presentation.js';
 export type WidgetView = {
     id: string;
     label: ReactNode;
     content: ReactNode;
-    empty: Pick<EmptyStateProps, 'title' | 'description'>;
+    empty: EmptyContent;
     isEmpty: boolean;
 };
 export type WidgetViewTabsProps<Views extends readonly WidgetView[] = readonly WidgetView[]> = {

package/dist/types/react/ui/data-identifiers.d.ts

@@ -1,4 +1,3 @@
-
 export type TableIdentifier = {
     catalog: string;
     schema: string;

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

@@ -0,0 +1,19 @@
+import type { ReactNode } from 'react';
+import type { DataReading } from '../../core/reading.js';
+import type { WidgetEvidence } from './WidgetEvidence.js';
+export type EmptyContent = {
+    title: ReactNode;
+    description?: ReactNode;
+};
+export type SkeletonContent = {
+    variant: 'metric' | 'panel' | 'ranking';
+    rows?: number;
+};
+/** A bound widget must explain empty results and link the reading to its evidence. */
+export type BoundWidgetReading<Data> = {
+    reading: DataReading<Data>;
+    isEmpty: (data: Data) => boolean;
+    empty: EmptyContent;
+    evidence: WidgetEvidence;
+    skeleton?: SkeletonContent;
+};

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

@@ -0,0 +1,3 @@
+import { type Theme } from '../../core/appearance.js';
+/** The parent theme takes precedence; only standalone viewers receive controls. */
+export declare function useAppAppearance(appearance: unknown, hostTheme?: Theme): import("../../core/appearance.js").ThemeController | undefined;

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

@@ -0,0 +1,3 @@
+import { type DataAppPresentation } from '../../core/presentation.js';
+/** Local preview verifies its parent before accepting presentation context. */
+export declare function useDataAppPresentation(): DataAppPresentation | undefined;

package/dist/types/react/view-controls.d.ts

@@ -2,11 +2,11 @@ import type { ReactNode } from 'react';
 import { type AppVariableValues, type VariableCollection } from './ui/variables.js';
 import type { ResolvedVariables } from './view.js';
 /** URL values resolve before facets; facet keys include their dependent inputs for cached, bounded loading. */
-export declare function useViewVariables<Variables extends VariableCollection>(definitions: Variables, loadFacet: (operation: string, input: unknown, signal: AbortSignal) => Promise<unknown>): {
+export declare function useViewVariables<Variables extends VariableCollection>(definitions: Variables, clientScope: string, loadFacet: (operation: string, input: unknown, signal: AbortSignal) => Promise<unknown>): {
     values: AppVariableValues<Variables>;
     set: <Key extends keyof Variables & string>(name: Key, value: AppVariableValues<Variables>[Key]) => void;
     reset: <Key extends keyof Variables & string>(name: Key) => void;
-    update: (next: Partial<AppVariableValues<Variables>>, history?: import("../core/variables.js").HistoryMode) => void;
+    update: (next: Partial<AppVariableValues<Variables>>, history?: import("../core/navigation.js").HistoryMode) => void;
     bind: <Key extends keyof Variables & string>(name: Key) => {
         value: AppVariableValues<Variables>[Key];
         onChange(value: AppVariableValues<Variables>[Key]): void;