@altertable/data-app 0.65.0 → 0.66.0

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

@@ -6,4 +6,4 @@ export type DateTimeTooltipProps = {
     children?: ReactNode;
 } & Omit<HelpPopoverProps, 'trigger' | 'triggerLabel' | 'label' | 'children'>;
 /** Pass the viewer's account time zone when known; the popover also exposes UTC and Unix time. */
-export declare function DateTimeTooltip({ date, timeZone, children, triggerClassName, panelClassName, ...props }: DateTimeTooltipProps): import("react").JSX.Element;
+export declare function DateTimeTooltip({ date, timeZone, children, panelProps, ...props }: DateTimeTooltipProps): import("react").JSX.Element;

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

@@ -1,4 +1,4 @@
 import { type CsvExport } from './csv-export.js';
 export declare function ExportControl({ csv }: {
-    csv: CsvExport;
+    csv?: CsvExport;
 }): import("react").JSX.Element;

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

@@ -1,14 +1,13 @@
 import { type ComponentPropsWithRef, type ReactNode, type RefObject } from 'react';
 import { type Placement } from '@floating-ui/react';
-export type HelpPopoverTriggerProps = Omit<ComponentPropsWithRef<'button'>, 'children' | 'type'>;
+import type { DataAppStyleHooks } from '../style-contract.js';
+export type HelpPopoverTriggerProps = Omit<ComponentPropsWithRef<'button'>, 'children' | 'type'> & DataAppStyleHooks;
 export type HelpPopoverPanelProps = Omit<ComponentPropsWithRef<'section'>, 'children' | 'role'>;
 export type HelpPopoverProps = {
     trigger: ReactNode;
     triggerLabel: string;
     label: string;
     children: ReactNode;
-    triggerClassName?: string;
-    panelClassName?: string;
     placement?: Placement;
     portalRoot?: RefObject<HTMLElement | null>;
     triggerProps?: HelpPopoverTriggerProps;
@@ -19,4 +18,4 @@ export type HelpPopoverProps = {
 /** A supplemental explanation that opens on click, Enter, or a deliberate mouse hover. Tabbing
  * past the trigger does not open it, and a click keeps a hover-opened panel in place.
  * triggerProps and panelProps target its two surfaces. */
-export declare function HelpPopover({ trigger, triggerLabel, label, children, triggerClassName, panelClassName, portalRoot, triggerProps, panelProps, placement, open: openProp, onOpenChange, }: HelpPopoverProps): import("react").JSX.Element;
+export declare function HelpPopover({ trigger, triggerLabel, label, children, portalRoot, triggerProps, panelProps, placement, open: openProp, onOpenChange, }: HelpPopoverProps): import("react").JSX.Element;

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

@@ -1,8 +1,10 @@
+import type { DataView } from '../../core/data-view.js';
 import type { DisclosedQuery } from '../../core/contract.js';
 import type { AboutEmpty } from './AboutData.js';
 import type { DataContext } from './data-context.js';
 export type InspectionDefaults = {
     dataContext: DataContext;
+    primaryView?: DataView<unknown, unknown>;
     empty?: AboutEmpty;
     queries?: DisclosedQuery[];
 };

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

@@ -0,0 +1,29 @@
+import { type ReactNode, type RefObject } from 'react';
+import { type AboutDataProps, type AboutTab } from './AboutData.js';
+type Inspection = {
+    key: string;
+    id: string;
+    props: AboutDataProps;
+    trigger: RefObject<HTMLButtonElement | null>;
+};
+type Selection = {
+    inspection: Inspection;
+    open: boolean;
+    tab: AboutTab;
+} | null;
+export declare const InspectionOwner: import("react").Context<{
+    subscribe(this: void, listener: () => void): () => void;
+    snapshot: () => Selection;
+    sync: () => void;
+    register(inspection: Inspection): void;
+    remove(key: string): void;
+    open(inspection: Inspection): void;
+    close(key: string): void;
+    controlled(inspection: Inspection, open: boolean | undefined): void;
+    selectTab(this: void, tab: AboutTab): void;
+} | null>;
+export declare const InspectionVisual: import("react").Context<boolean>;
+export declare function InspectionProvider({ children }: {
+    children: ReactNode;
+}): string | number | bigint | boolean | import("react").JSX.Element | Iterable<ReactNode> | Promise<string | number | bigint | boolean | Iterable<ReactNode> | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | import("react").ReactPortal | null | undefined> | null | undefined;
+export {};

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

@@ -0,0 +1,7 @@
+import type { ChartItem, ValueChartProps } from './chart-data.js';
+export type LineChartItem = ChartItem;
+export type LineChartProps = ValueChartProps;
+/** Equally spaced finite samples in supplied order; fill missing periods explicitly.
+ * Supports negative values, single points, and horizontal scrolling for long series.
+ * Compose inside VisualizationWidget; hover/touch tooltips need no caller state. */
+export declare function LineChart(props: LineChartProps): import("react").JSX.Element;

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

@@ -1,17 +1,17 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
-import { type WidgetStatus } from './RequestHint.js';
+import type { WidgetStatus } from './RequestHint.js';
 import type { WidgetEvidence } from './WidgetEvidence.js';
-import { type MetricComparison } from './comparison.js';
+import { type MetricComparison } from './metric-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;
+    annotationId?: string;
     description?: ReactNode;
     comparison?: MetricComparison;
     evidence?: WidgetEvidence;
     action?: ReactNode;
-    insight?: ReactNode;
     status?: WidgetStatus;
     visual?: ReactNode;
 } & Omit<ComponentPropsWithRef<'div'>, 'about' | 'children'>;
@@ -31,6 +31,7 @@ type UnboundMetricWidgetProps = MetricWidgetBaseProps & ({
     value?: never;
     format?: never;
 })));
+/** VisualizationWidget with a formatted metric, optional comparison, and evidence. */
 export type MetricWidgetProps = UnboundMetricWidgetProps | (Omit<MetricWidgetBaseProps, 'label' | 'comparison' | 'evidence'> & {
     metric: MetricDefinition;
     reading: MetricReading;

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

@@ -0,0 +1,8 @@
+import type { ChartItem, ValueChartProps } from './chart-data.js';
+export type PieChartItem = ChartItem;
+export type PieChartProps = ValueChartProps;
+/** Nonnegative, mutually exclusive parts; shares use the sum of supplied items.
+ * Include Other to represent the whole. Zero values remain in the legend; all-zero
+ * data shows an empty circle. Colors follow item order. Compose inside VisualizationWidget;
+ * hover/touch tooltips coordinate slice and legend emphasis without caller state. */
+export declare function PieChart({ items, unit, ariaLabel, formatValue, }: PieChartProps): import("react").JSX.Element;

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

@@ -20,14 +20,11 @@ export type PresentStoryProps = {
     scope?: ReactNode;
     dataContext: DataContext;
     theme?: ThemeController;
-    launcherProps?: Omit<ComponentPropsWithRef<'span'>, 'children'>;
-    dialogProps?: Omit<ComponentPropsWithRef<'dialog'>, 'children' | 'aria-labelledby' | 'open'>;
     headerActions?: ReactNode;
     footer?: ReactNode;
 } & Omit<ComponentPropsWithRef<'button'>, 'title'>;
 /**
  * Uses an already loaded snapshot. Navigation is stored in `?present=1&step=`, and step
- * inspection uses `?about=`. `launcherProps` targets the outer span; `dialogProps` targets the
- * modal.
+ * inspection uses `?about=`. The presentation owns its modal structure.
  */
-export declare function PresentStory({ title, findings, empty, scope, dataContext, theme, launcherProps, dialogProps, headerActions, footer, children, className, onClick, disabled, ref, ...props }: PresentStoryProps): import("react").JSX.Element;
+export declare function PresentStory({ title, findings, empty, scope, dataContext, theme, headerActions, footer, children, className, onClick, disabled, ref, ...props }: PresentStoryProps): import("react").JSX.Element;

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

@@ -3,8 +3,7 @@ export type RefreshControlProps = {
     refreshing: boolean;
     children: ReactNode;
     label?: string;
-    statusProps?: Omit<ComponentPropsWithRef<'div'>, 'children' | 'role'>;
     status?: ReactNode;
 } & Omit<ComponentPropsWithRef<'div'>, 'children'>;
 /** Show refresh progress just before its action after a short delay. */
-export declare function RefreshControl({ refreshing, children, label, statusProps, status, className, ...props }: RefreshControlProps): import("react").JSX.Element;
+export declare function RefreshControl({ refreshing, children, label, status, className, ...props }: RefreshControlProps): import("react").JSX.Element;

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

@@ -0,0 +1,17 @@
+import type { ScatterChartItem } from './chart-data.js';
+export type { ScatterChartItem } from './chart-data.js';
+export type ScatterChartProps = {
+    items: readonly ScatterChartItem[];
+    xLabel: string;
+    yLabel: string;
+    xUnit: string;
+    yUnit: string;
+    ariaLabel: string;
+    formatX?: (value: number) => string;
+    formatY?: (value: number) => string;
+};
+/** Independent finite X/Y observations on linear axes that include zero.
+ * Negative and constant coordinates are supported. Axis labels and units describe
+ * tooltips as well as the plot; formatX/formatY format ticks and tooltip values.
+ * Compose inside VisualizationWidget; hover/touch tooltips need no caller state. */
+export declare function ScatterChart({ items, xLabel, yLabel, xUnit, yUnit, ariaLabel, formatX, formatY, }: ScatterChartProps): import("react").JSX.Element;

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

@@ -12,11 +12,10 @@ export type SearchFieldProps = {
     busy?: boolean;
     resetValue?: string;
     inputProps?: Omit<ComponentPropsWithRef<'input'>, 'type' | 'value' | 'children'>;
-    clearButtonProps?: Omit<ComponentPropsWithRef<'button'>, 'type' | 'children'>;
     children?: ReactNode;
 } & Omit<ComponentPropsWithRef<'form'>, 'onChange' | 'onSubmit' | 'children'>;
 /**
  * The caller owns filtering, URL state, and whether search runs while typing or on submit.
  * Escape and Clear reset the query.
  */
-export declare function SearchField({ label, value, onChange, onSubmit, placeholder, showLabel, size, description, status, busy, resetValue, inputProps, clearButtonProps, children, className, ...props }: SearchFieldProps): import("react").JSX.Element;
+export declare function SearchField({ label, value, onChange, onSubmit, placeholder, showLabel, size, description, status, busy, resetValue, inputProps, children, className, ...props }: SearchFieldProps): import("react").JSX.Element;

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

@@ -1,7 +1,9 @@
 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, onKeyDown, ...props }: Omit<ComponentPropsWithRef<'input'>, 'size' | 'children'> & {
+export declare function SearchInput({ focusRing, size, endAction, loading, className, onKeyDown, ...props }: Omit<ComponentPropsWithRef<'input'>, 'size' | 'children'> & {
     size?: 'default' | 'compact';
+    /** Menu search delegates focus indication to the active option. */
+    focusRing?: boolean;
     endAction?: ReactNode;
     /** Replaces the search glyph in its existing space; input and results remain usable. */
     loading?: boolean;

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

@@ -9,10 +9,11 @@ export type SheetProps = {
     headerActions?: ReactNode;
     footer?: ReactNode;
     wide?: boolean;
+    placement?: 'side' | 'center';
     returnFocus?: RefObject<HTMLElement | null>;
 } & SheetDialogProps;
 /**
  * Uses the native dialog top layer and focus trap. Closing keeps the modal mounted until its
  * exit transition completes.
  */
-export declare function Sheet({ open, onOpenChange, title, description, children, headerActions, footer, wide, returnFocus, className, onCancel, onClose, onClick, onTransitionEnd, ref, ...props }: SheetProps): import("react").JSX.Element;
+export declare function Sheet({ open, onOpenChange, title, description, children, headerActions, footer, wide, placement, returnFocus, className, onCancel, onClose, onClick, onTransitionEnd, ref, ...props }: SheetProps): import("react").JSX.Element;

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

@@ -1,5 +1,8 @@
 import type { ComponentPropsWithRef } from 'react';
-export type SkeletonProps = Omit<ComponentPropsWithRef<'span'>, 'children' | 'aria-hidden'>;
+export type SkeletonProps = Omit<ComponentPropsWithRef<'span'>, 'children' | 'aria-hidden'> & {
+    /** Align a text-sized placeholder with surrounding prose. */
+    inline?: boolean;
+};
 /** Decorative loading placeholder that fades in only when loading takes a moment.
  * Put the accessible status on its container. */
-export declare function Skeleton({ className, ...props }: SkeletonProps): import("react").JSX.Element;
+export declare function Skeleton({ inline, className, ...props }: SkeletonProps): import("react").JSX.Element;

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

@@ -0,0 +1,4 @@
+import { type StaticDataAppProps } from './DataAppFrame.js';
+export type DataAppProps = StaticDataAppProps;
+/** Setup and static screens; fetched data uses the declared-view DataApp. */
+export declare function DataApp(props: DataAppProps): import("react").JSX.Element;

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

@@ -14,34 +14,37 @@ export type TableWidgetColumn<Row> = {
     cell: (row: Row, hit?: SearchHit<Row>) => ReactNode;
 };
 export type TableWidgetSearch<Row> = Omit<DataTableSearch, 'itemCount'> & Pick<SearchItemsOptions<Row>, 'attributes' | 'mode' | 'fuzzyThreshold'>;
+export type TableDisplayMode = {
+    /** Positive integer preview cap after search; disables pagination. */
+    limit: number;
+    pagination?: never;
+} | {
+    /** Local pagination after search: 10 rows by default, false shows all supplied rows.
+     * pageSize must be a positive integer. Counts refer only to supplied rows.
+     * The widget owns bottom-footer controls and shares the current page with inspection. */
+    pagination?: {
+        pageSize: number;
+    } | false;
+    limit?: never;
+};
 type TableWidgetBaseProps<Row> = {
     title: ReactNode;
+    annotationId?: string;
     count?: number;
     description?: ReactNode;
     columns: readonly [TableWidgetColumn<Row>, ...TableWidgetColumn<Row>[]];
     /** Unique, nonempty row identity. Numeric keys must be finite; 1 and "1" collide. */
     rowKey: (row: Row) => string | number;
-    insight?: ReactNode;
     status?: WidgetStatus;
     action?: ReactNode;
     evidence?: WidgetEvidence;
     search?: TableWidgetSearch<Row>;
     /** Valid result with no rows; the header remains visible. */
-    empty: EmptyContent;
-} & ({
-    /** Positive integer preview cap after search; disables pagination. */
-    limit: number;
-    pagination?: never;
-} | {
-    /** Local pagination after search: 10 rows by default, false shows all supplied rows.
-     * pageSize must be a positive integer. Counts refer only to supplied rows.
-     * The widget owns bottom-footer controls and shares the current page with inspection. */
-    pagination?: {
-        pageSize: number;
-    } | false;
-    limit?: never;
-}) & Omit<ComponentPropsWithRef<'section'>, 'about' | 'title' | 'children'>;
-/** Column definitions own both header and body semantics; the first column is the row header. */
+    emptyFallback: EmptyContent;
+} & TableDisplayMode & Omit<ComponentPropsWithRef<'section'>, 'about' | 'title' | 'children'>;
+/** Composes VisualizationWidget with DataTable, search, and local pagination.
+ * Columns own header and body semantics; the first column is the row header.
+ * Use DataTable inside VisualizationWidget directly for custom table markup. */
 export type TableWidgetProps<Row> = TableWidgetBaseProps<Row> & ({
     rows: readonly Row[];
     reading?: never;

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

@@ -1,5 +1,9 @@
-import { Tabs, TabList, Tab, TabPanels, TabPanel } from 'react-aria-components/Tabs';
+import { type ComponentPropsWithRef } from 'react';
+import { Tabs as AriaTabs, TabList, Tab as AriaTab, TabPanels, TabPanel as AriaTabPanel } 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 };
+export { TabList, TabPanels };
+export declare function Tab(props: ComponentPropsWithRef<typeof AriaTab>): import("react").JSX.Element;
+export declare function TabPanel(props: ComponentPropsWithRef<typeof AriaTabPanel>): import("react").JSX.Element;
+export declare function Tabs({ className, ...props }: ComponentPropsWithRef<typeof AriaTabs>): import("react").JSX.Element;
 /** Keep a page-level tab in `?view=`; reserve `?tab=` for the inspect sheet. */
 export declare function useViewTab<View extends string>(views: readonly View[], fallback: View): [View, (key: string | number) => void];

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

@@ -5,7 +5,8 @@ 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.
+/** Narrative sibling of VisualizationWidget, composing DataWidget with TextContent.
+ * Use TextContent directly for borderless prose. 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>;

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

@@ -11,12 +11,13 @@ export type TooltipProps = {
     content: ReactNode;
     children: ReactNode;
     variant?: 'hint' | 'chart';
+    onOpenChange?: (open: boolean) => void;
     align?: 'start' | 'center' | 'end';
     placement?: 'top' | 'bottom';
     portalRoot?: RefObject<HTMLElement | null>;
-    tooltipProps?: Omit<ComponentPropsWithRef<'span'>, 'children' | 'role'>;
 } & Omit<ComponentPropsWithRef<'span'>, 'children' | 'content'>;
 /** Short visual hint for an already labeled control. variant="chart" follows the cursor
- * on hover and toggles on tap so a bar or point can show the period and value. Hint
+ * on hover and toggles on tap so a bar or point can show the period and value. Chart
+ * tooltips dismiss on scroll and do not open on keyboard focus. Hint
  * tooltips hide once the control is pressed. Escape closes either. */
-export declare function Tooltip({ content, children, variant, align, placement, portalRoot, tooltipProps, className, ref, onPointerEnter, onPointerMove, onPointerLeave, onPointerDown, onFocusCapture, onBlurCapture, ...props }: TooltipProps): import("react").JSX.Element;
+export declare function Tooltip({ content, children, onOpenChange, variant, align, placement, portalRoot, className, ref, onPointerEnter, onPointerMove, onPointerLeave, onPointerDown, onFocusCapture, onBlurCapture, ...props }: TooltipProps): import("react").JSX.Element;

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

@@ -0,0 +1,5 @@
+import type { ValueChartProps } from './chart-data.js';
+/** Ordered, equally spaced samples; negative values share an explicit zero baseline. */
+export declare function TrendChart({ items, unit, ariaLabel, formatValue, area, }: ValueChartProps & {
+    area?: boolean;
+}): import("react").JSX.Element;

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

@@ -6,4 +6,4 @@ export type UpdatedAtProps = {
     label?: string;
     children?: ReactNode;
 } & Omit<DateTimeTooltipProps, 'date' | 'children'>;
-export declare function UpdatedAt({ timestamp, locale, label, children, triggerClassName, ...props }: UpdatedAtProps): import("react").JSX.Element;
+export declare function UpdatedAt({ timestamp, locale, label, children, triggerProps, ...props }: UpdatedAtProps): import("react").JSX.Element;

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

@@ -1,22 +1,18 @@
 import { type ComponentPropsWithRef, type ReactNode } from 'react';
-import type { WidgetEvidence } from './WidgetEvidence.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?: WidgetStatus;
-    empty?: EmptyContent;
+import { type DataWidgetProps } from './DataWidget.js';
+import type { BoundWidgetReading } from './presentation.js';
+type VisualizationWidgetBaseProps = Pick<DataWidgetProps, 'title' | 'annotationId' | 'description' | 'count' | 'action' | 'evidence' | 'status' | 'emptyFallback'> & {
+    /** Footer controls, such as table pagination. */
+    footer?: ReactNode;
 } & Omit<ComponentPropsWithRef<'section'>, 'about' | 'title' | 'children'>;
 type UnboundVisualizationWidgetProps = VisualizationWidgetBaseProps & ({
     loading: true;
+    loadingContent?: ReactNode;
     visual?: never;
 } | {
     loading?: false;
     visual: ReactNode;
+    loadingContent?: never;
 });
 export type VisualizationWidgetView<Data> = {
     /** Stable, nonempty identity; unique within this widget. */
@@ -28,8 +24,10 @@ type BoundVisualizationWidgetBase<Data> = VisualizationWidgetBaseProps & BoundWi
     visual?: never;
     loading?: never;
 };
-/** The widget owns alternate-view selection and shares it with inspection.
- * Custom chart interactions remain controlled by the caller, above both mounts. */
+/** DataWidget frame for charts, DataTable, metrics, or a custom data display.
+ * Owns alternate-view selection and shares it with inspection. Built-in charts own
+ * transient tooltips; lift persistent custom interactions above both mounts.
+ * For narrative prose use the sibling TextWidget, which composes DataWidget directly. */
 export type VisualizationWidgetProps<Data = unknown> = UnboundVisualizationWidgetProps | (BoundVisualizationWidgetBase<Data> & {
     children: (data: Data) => ReactNode;
     views?: never;
@@ -40,5 +38,6 @@ export type VisualizationWidgetProps<Data = unknown> = UnboundVisualizationWidge
     initialView?: string;
     children?: never;
 });
+/** Compose an unframed visual with the shared heading and inspection. */
 export declare function VisualizationWidget<Data>(props: VisualizationWidgetProps<Data>): import("react").JSX.Element;
 export {};

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

@@ -4,7 +4,7 @@ export type WidgetView = {
     id: string;
     label: ReactNode;
     content: ReactNode;
-    empty: EmptyContent;
+    emptyFallback: EmptyContent;
     isEmpty: boolean;
 };
 export type WidgetViewTabsProps<Views extends readonly WidgetView[] = readonly WidgetView[]> = {

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

@@ -0,0 +1,25 @@
+/** Ordered category or time-series sample. IDs are unique and nonblank; values are finite. */
+export type ChartItem = {
+    id: string;
+    label: string;
+    value: number;
+};
+export type ValueChartProps = {
+    /** Ordered samples; the chart validates IDs and values when rendering. */
+    items: readonly ChartItem[];
+    unit: string;
+    ariaLabel: string;
+    formatValue?: (value: number) => string;
+};
+/** Independent observation on two finite numeric axes. */
+export type ScatterChartItem = {
+    id: string;
+    label: string;
+    x: number;
+    y: number;
+};
+type ChartKind = 'bar' | 'line' | 'area' | 'pie' | 'scatter';
+type ItemFor<Kind extends ChartKind> = Kind extends 'scatter' ? ScatterChartItem : ChartItem;
+/** Validate the data consumed by every chart. */
+export declare function validateChartItems<Kind extends ChartKind>(kind: Kind, items: readonly ItemFor<Kind>[]): void;
+export {};

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

@@ -15,15 +15,26 @@ export type DataContext = {
     identifiers?: Readonly<Record<string, DataIdentifierDefinition>>;
     queryNames?: Readonly<Record<string, string>>;
 };
-export declare function defineDataContext<const Context extends DataContext>(context: Context): Context;
-export declare function evidenceFor<const Context extends DataContext, const Names extends Record<string, string> = Record<string, string>>(context: Context, names?: Names): (evidence: {
+export type MetricDeclaration = {
     id: string;
-    glossaryIds?: readonly (keyof Context['glossary'] & string)[];
-    queryNames?: readonly Names[keyof Names][];
-}) => {
+    glossaryId: string;
+    label?: string;
+    format: MetricFormat;
+    favorableDirection?: 'up' | 'down';
+    queryNames?: readonly string[];
+};
+export type EvidenceDeclaration = {
     id: string;
-    glossaryIds: (keyof Context["glossary"] & string)[] | undefined;
-    queryNames: Names[keyof Names][] | undefined;
+} & ({
+    glossaryIds: readonly [string, ...string[]];
+    queryNames?: readonly string[];
+} | {
+    queryNames: readonly [string, ...string[]];
+    glossaryIds?: readonly string[];
+});
+export type AuthoringDataContext = DataContext & {
+    metric(definition: MetricDeclaration): MetricDefinition;
+    evidence(definition: EvidenceDeclaration): WidgetEvidence;
 };
 /** Bind glossary query references and card evidence to the same registry. */
 export declare function createDataContext<const Names extends Record<string, string>>(queryNames: Names): <const Context extends Omit<DataContext, 'glossary'> & {

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

@@ -1,6 +1,7 @@
 import { type LucideProps } from 'lucide-react';
 /** Use semantic names to keep icon meaning and optical size consistent across controls. */
 declare const brandedIcons: {
+    readonly annotate: import("lucide-react").LucideIcon;
     readonly cancel: import("lucide-react").LucideIcon;
     readonly calendar: import("lucide-react").LucideIcon;
     readonly clock: import("lucide-react").LucideIcon;

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

@@ -0,0 +1,74 @@
+/** Direct UI composition and static screens. Requests use declared views from /react. */
+export { injectDataAppShellStyles } from '../shellStyles.js';
+export { DataAppProvider } from '../mount.js';
+export { GettingStarted } from './GettingStarted.js';
+export { DataWidget } from './DataWidget.js';
+export type { WidgetStatus } from './RequestHint.js';
+export type { DataWidgetProps } from './DataWidget.js';
+export { TextWidget } from './TextWidget.js';
+export type { TextWidgetProps } from './TextWidget.js';
+export { VisualizationWidget } from './VisualizationWidget.js';
+export type { VisualizationWidgetProps } from './VisualizationWidget.js';
+export { TableWidget } from './TableWidget.js';
+export type { TableWidgetProps } from './TableWidget.js';
+export { DataTable, DataTableEmptyRow, DataTableTimestamp, DataTableShare, } from './DataTable.js';
+export type { DataTableProps, DataTableSearch, DataTableEmptyRowProps, DataTableTimestampProps, } from './DataTable.js';
+export { MetricWidget } from './MetricWidget.js';
+export type { MetricWidgetProps } from './MetricWidget.js';
+export { DimensionPicker } from './DimensionPicker.js';
+export { DataAppSkeleton } from './DataAppSkeleton.js';
+export type { DataAppSkeletonProps } from './DataAppSkeleton.js';
+export { LiveControl } from './LiveControl.js';
+export type { LiveControlProps, LiveIntervalSeconds, } from './LiveControl.js';
+export { DateRangePicker } from './DateRangePicker.js';
+export type { DatePresetId, DateRange, DateRangePickerProps, } from './DateRangePicker.js';
+export { useAppVariables } from './variables.js';
+export { SearchField } from './SearchField.js';
+export type { SearchFieldProps } from './SearchField.js';
+export { searchItems } from './searchItems.js';
+export type { SearchAttribute, SearchHit, SearchItemsOptions, SearchMatchValue, SearchRange, } from './searchItems.js';
+export { SearchMatch } from './SearchMatch.js';
+export type { SearchMatchProps } from './SearchMatch.js';
+export { Combobox } from './Combobox.js';
+export type { ComboboxOption, ComboboxProps } from './Combobox.js';
+export { GradientScroll } from './GradientScroll.js';
+export type { GradientScrollProps } from './GradientScroll.js';
+export { Tabs, TabList, Tab, TabPanels, TabPanel, useViewTab, } from './Tabs.js';
+export { GlossaryExplanation } from './GlossaryExplanation.js';
+export type { GlossaryExplanationProps } from './GlossaryExplanation.js';
+export { GlossaryDefinition } from './GlossaryDefinition.js';
+export type { GlossaryDefinitionProps } from './GlossaryDefinition.js';
+export { AboutData } from './AboutData.js';
+export type { AboutDataProps, AboutEmpty, AboutSubject, AboutTab, } from './AboutData.js';
+export { PresentStory } from './PresentStory.js';
+export type { PresentStoryProps } from './PresentStory.js';
+export type { StoryFinding, BoundStory } from './story.js';
+export { Checkbox } from './Checkbox.js';
+export type { CheckboxProps } from './Checkbox.js';
+export { AppIcon } from './icons.js';
+export type { AppIconName, AppIconProps } from './icons.js';
+export { Sheet } from './Sheet.js';
+export type { SheetProps } from './Sheet.js';
+export { HelpPopover } from './HelpPopover.js';
+export type { HelpPopoverProps } from './HelpPopover.js';
+export { DataApp } from './StaticDataApp.js';
+export type { DataAppProps } from './StaticDataApp.js';
+export { injectDataAppStyles } from '../styles.js';
+export { Tooltip, TooltipProvider } from './Tooltip.js';
+export type { TooltipProps, TooltipProviderProps, } from './Tooltip.js';
+export { LineChart } from './LineChart.js';
+export type { LineChartProps, LineChartItem } from './LineChart.js';
+export { AreaChart } from './AreaChart.js';
+export type { AreaChartProps, AreaChartItem } from './AreaChart.js';
+export { PieChart } from './PieChart.js';
+export type { PieChartProps, PieChartItem } from './PieChart.js';
+export { ScatterChart } from './ScatterChart.js';
+export type { ScatterChartProps, ScatterChartItem, } from './ScatterChart.js';
+export { BarChart } from './BarChart.js';
+export type { BarChartProps, BarChartItem } from './BarChart.js';
+export { DataValue } from './DataValue.js';
+export type { DataValueProps } from './DataValue.js';
+export type { CsvExport, CsvTable } from './csv-export.js';
+export type { TableWidgetColumn } from './TableWidget.js';
+export type { DataReading, MetricReading } from '../../core/reading.js';
+export type { DataAppStyle, DataAppStyleToken, DataAppStyleHooks, } from '../style-contract.js';

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

@@ -8,4 +8,4 @@ export type MetricDefinition = {
     favorableDirection?: 'up' | 'down';
     evidence: WidgetEvidence;
 };
-export declare function metricComparison(metric: MetricDefinition, reading: MetricReading): import("./comparison.js").MetricComparison | undefined;
+export declare function metricComparison(metric: MetricDefinition, reading: MetricReading): import("./metric-comparison.js").MetricComparison | undefined;

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

@@ -7,13 +7,17 @@ export type EmptyContent = {
 };
 export type SkeletonContent = {
     variant: 'metric' | 'panel' | 'ranking';
+    /**
+     * Placeholder rows, clamped to 0–100.
+     * @default 4
+     */
     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;
+    emptyFallback: EmptyContent;
     evidence: WidgetEvidence;
     skeleton?: SkeletonContent;
 };

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

@@ -9,6 +9,12 @@ export type Shortcut = {
     key: string;
 };
 export declare const shortcuts: {
+    readonly annotate: {
+        readonly modifier: 'mod';
+        readonly shift: true;
+        readonly code: 'Period';
+        readonly key: '.';
+    };
     readonly refresh: {
         readonly modifier: 'alt';
         readonly code: 'KeyR';
@@ -29,4 +35,4 @@ export declare function shortcutLabel({ modifier, shift, key }: Shortcut): strin
 export declare function ariaKeyShortcuts({ modifier, shift, key }: Shortcut): string;
 export declare function isEditingTarget(target: EventTarget | null): boolean;
 /** Bind a page-level shortcut. Ignored while typing or while a modal layer is open. */
-export declare function useShortcut(shortcut: Shortcut, action: () => void, enabled?: boolean): void;
+export declare function useShortcut(shortcut: Shortcut, action: () => void, enabled?: boolean, allowWhileEditing?: boolean): void;