@altertable/data-app 0.66.0 → 0.68.0

package/dist/types/core/operation.d.ts

@@ -1,15 +1,14 @@
-import type { DataOperations, Lakehouse, DataQueryBody } from './operation-types.js';
+import type { DataOperations, Lakehouse, OperationContext, DataQueryBody } from './operation-types.js';
 type Operation = DataOperations[string];
 type OperationExecutionOptions = {
     operationName: string;
     lakehouse: Lakehouse;
     signal: AbortSignal;
-    /** Include query evidence in the response; this does not keep browser-owned SQL private. */
-    includeSql: boolean;
     requestId: string;
+    queryParams?: OperationContext['queryParams'];
 };
 /** Shared operation execution. Adapters own authorization, delivery, and public errors. */
-export declare function executeDataOperation(operation: Operation, value: unknown, { operationName, lakehouse, signal: requestSignal, includeSql, requestId, }: OperationExecutionOptions): Promise<{
+export declare function executeDataOperation(operation: Operation, value: unknown, { operationName, lakehouse, signal: requestSignal, requestId, queryParams, }: OperationExecutionOptions): Promise<{
     body: DataQueryBody<unknown>;
     serializedBody: string;
 }>;

package/dist/types/core/queries.d.ts

@@ -0,0 +1,16 @@
+export type QueryParameterValue = string | number | boolean | null;
+type QueryDefinition = {
+    statement: string;
+    params: Readonly<Record<string, {
+        defaultValue?: QueryParameterValue;
+    }>>;
+};
+export type QueryDefinitions = Readonly<Record<string, QueryDefinition>>;
+/** Parameters are scalar SQL values, never identifiers or SQL fragments. */
+export type QueryParameters = Readonly<Record<string, QueryParameterValue>>;
+export declare function isQueryParameters(value: unknown): value is QueryParameters;
+/** Retain authored statements and defaults, rejecting empty SQL and invalid scalar defaults. */
+export declare function snapshotQueries(definitions: QueryDefinitions): QueryDefinitions;
+/** Context owns protected values; callers supply filters; defaults fill remaining declarations. */
+export declare function resolveQueryParameters(declarations: QueryDefinition['params'], values: Partial<QueryParameters>, context: QueryParameters): QueryParameters;
+export {};

package/dist/types/core/uuid.d.ts

@@ -0,0 +1,2 @@
+/** Opaque documents can lack randomUUID even when cryptographic randomness is available. */
+export declare function randomUuid(): string;

package/dist/types/core/variables.d.ts

@@ -1,25 +1,25 @@
 import { type DatePresetId, type DateRange } from './date-range.js';
 import type { DateRangeContract, DateRangeRequest } from './contract.js';
 import type { DimensionSelection, DimensionVariable } from './dimension.js';
+import type { NumberFilter, BooleanFilter } from './filters.js';
 import type { HistoryMode } from './navigation.js';
 export type { HistoryMode } from './navigation.js';
 /** An app-owned value with one URL representation. Controls never parse or write routes. */
-export type AppVariable<Value, Kind extends string = Value extends string ? 'text' | 'select' : 'dateRange'> = {
+export type AppVariable<Value, Kind extends string = string> = {
     kind: Kind;
     label?: string;
-    options?: readonly {
-        id: string;
-        label: string;
-    }[];
     urlKeys: readonly string[];
     defaultValue: Value;
+    /** Unrestricted value, when this variable represents a filter. */
+    clearValue?: Value;
+    describe?: (value: Value) => string;
     history: HistoryMode;
     read: (params: URLSearchParams) => Value;
     write: (value: Value) => Record<string, string | null>;
     valid: (value: Value) => boolean;
     same: (left: Value, right: Value) => boolean;
 };
-export type VariableCollection = Record<string, AppVariable<string> | DateRangeVariable | DimensionVariable<any>>;
+export type VariableCollection = Record<string, SearchVariable | ChoiceVariable | MultiChoiceVariable | DateRangeVariable | DimensionVariable<any> | NumberFilter | BooleanFilter>;
 export type AppVariableValues<Variables> = {
     [Key in keyof Variables]: Variables[Key] extends DimensionVariable<infer Value> ? DimensionSelection<Value> : Variables[Key] extends AppVariable<infer Value, string> ? Value : never;
 };
@@ -31,13 +31,32 @@ type ScalarVariableOptions = {
     defaultValue?: string;
     history?: HistoryMode;
 };
-/** A local text filter. Typing replaces the current history entry by default. */
-export declare function textVariable({ key, label, defaultValue, history, }: ScalarVariableOptions): AppVariable<string>;
-/** A single choice. Supply values when the option set is known before data loads. */
-export declare function selectVariable({ key, label, defaultValue, values, history, }: ScalarVariableOptions & {
+export type SearchVariable = AppVariable<string, 'search'>;
+export type ChoiceOption = {
+    id: string;
+    label: string;
+    description?: string;
+};
+export type ChoiceVariable = AppVariable<string, 'choice'> & {
+    options: readonly ChoiceOption[];
+};
+export type MultiChoiceVariable = AppVariable<readonly string[], 'multiChoice'> & {
+    options: readonly ChoiceOption[];
+    maxSelected: number;
+};
+/** Search query state; typing replaces history by default. */
+export declare function searchVariable({ key, label, defaultValue, history, }: ScalarVariableOptions): SearchVariable;
+/** Validate labeled choices before controls or URL state consume them. */
+export declare function validateChoiceOptions(options: readonly ChoiceOption[]): void;
+export declare function choiceVariable({ key, label, defaultValue, options, history, }: ScalarVariableOptions & {
     defaultValue: string;
-    values?: readonly string[];
-}): AppVariable<string>;
+    options: readonly ChoiceOption[];
+}): ChoiceVariable;
+export declare function multiChoiceVariable({ key, label, defaultValue, options, maxSelected, history, }: Omit<ScalarVariableOptions, 'defaultValue'> & {
+    defaultValue?: readonly string[];
+    options: readonly ChoiceOption[];
+    maxSelected?: number;
+}): MultiChoiceVariable;
 export type DateRangeSelection = {
     kind: 'preset';
     id: DatePresetId;
@@ -60,7 +79,7 @@ export type DateRangeVariableOptions = {
     /** Opt into a URL-backed comparison with the preceding equal-length range. */
     comparison?: boolean;
 };
-export type DateRangeVariable = AppVariable<DateRangeSelection> & {
+export type DateRangeVariable = AppVariable<DateRangeSelection, 'dateRange'> & {
     kind: 'dateRange';
     supportsComparison: boolean;
     input: (selection: DateRangeSelection) => DateRangeRequest;

package/dist/types/embed/runtime-html.d.ts

@@ -0,0 +1,2 @@
+export declare const PAGE_CSP = "default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; img-src data: blob:; connect-src 'none'; form-action 'none'; base-uri 'none'";
+export declare function runtimeHtml(parentOrigin: string): string;

package/dist/types/embed/source.d.ts

@@ -4,7 +4,8 @@ export type DataAppSource = {
     url: string;
 } | {
     type: 'bundle';
-    bootstrapUrl: string;
+    /** Omit to use the packaged, network-isolated data document. */
+    bootstrapUrl?: string;
     javascript: string;
 };
 export type DataAppSourceOptions = DataAppHostOptions & {

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+/** Portable data app declarations; safe in browser and server modules. */
+export { defineDataApp, dataAppTitle } from './core/config.js';
+export type { DataAppConfig, DataAppDefinition, QueryDefinitions, QueryParameterValue, } from './core/config.js';

package/dist/types/react/annotations/AnnotationBar.d.ts

@@ -1,6 +1,12 @@
+import { type Ref } from 'react';
 import type { Theme } from '../../core/appearance.js';
 import { type DataAppAnnotationDraft } from '../../core/annotations.js';
+export type AnnotationBarHandle = {
+    /** Submit through the same guards, pending state, and retry feedback as the Send button. */
+    send: () => Promise<void>;
+};
 export type AnnotationBarProps = {
+    ref?: Ref<AnnotationBarHandle>;
     annotations: readonly DataAppAnnotationDraft[];
     active?: boolean;
     theme?: Theme;
@@ -21,4 +27,4 @@ export type AnnotationBarProps = {
     onClose: () => void;
 };
 /** Host-owned batch controls. Collection changes and agent submission stay with the outer app. */
-export declare function AnnotationBar({ annotations, active, theme, disabled, deletedAnnotationId, onUndoDelete, onDismissUndo, hasUnsavedChanges, pinsVisible, onPinsVisibleChange, onSelect, onDelete, onClear, requestDiscard, onSend, onClose, }: AnnotationBarProps): import("react").JSX.Element | null;
+export declare function AnnotationBar({ ref, annotations, active, theme, disabled, deletedAnnotationId, onUndoDelete, onDismissUndo, hasUnsavedChanges, pinsVisible, onPinsVisibleChange, onSelect, onDelete, onClear, requestDiscard, onSend, onClose, }: AnnotationBarProps): import("react").JSX.Element | null;

package/dist/types/react/annotations/AnnotationEditor.d.ts

@@ -8,8 +8,9 @@ type AnnotationEditorProps = {
     disabled: boolean;
     onCommentChange: (comment: string) => void;
     onSubmit: () => void;
+    onSend: () => void;
     onRetryScreenshot: () => void;
     onShakeEnd: () => void;
 };
-export declare function AnnotationEditor({ editor, editorRef, textareaRef, style, disabled, onCommentChange, onSubmit, onRetryScreenshot, onShakeEnd, }: AnnotationEditorProps): import("react").JSX.Element;
+export declare function AnnotationEditor({ editor, editorRef, textareaRef, style, disabled, onCommentChange, onSubmit, onSend, onRetryScreenshot, onShakeEnd, }: AnnotationEditorProps): import("react").JSX.Element;
 export {};

package/dist/types/react/annotations/useDataAppAnnotations.d.ts

@@ -1,5 +1,8 @@
 /** Bind annotation delivery to this app's current iframe bridge. The host owns storage and submission. */
 export declare function useDataAppAnnotations(): {
+    requestSendAnnotations(options?: {
+        signal?: AbortSignal;
+    }): Promise<null>;
     reportAnnotationEditorState(state: {
         hasUnsavedChanges: boolean;
     }, options?: {

package/dist/types/react/app-context.d.ts

@@ -0,0 +1,3 @@
+import type { DataAppConfig } from '../core/config.js';
+export declare const DataAppContext: import("react").Context<DataAppConfig | null>;
+export declare function useDataApp(): DataAppConfig;

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

@@ -46,8 +46,8 @@ 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 { textVariable, selectVariable, dateRangeVariable, } from './ui/variables.js';
-export type { AppVariable, AppVariableValues, DateRangeSelection, DateRangeVariable, DateRangeVariableOptions, } from './ui/variables.js';
+export { searchVariable, choiceVariable, multiChoiceVariable, dateRangeVariable, } from './ui/variables.js';
+export type { AppVariable, AppVariableValues, ChoiceOption, ChoiceVariable, MultiChoiceVariable, SearchVariable, DateRangeSelection, DateRangeVariable, DateRangeVariableOptions, } from './ui/variables.js';
 export { PeriodSummary } from './ui/PeriodSummary.js';
 export type { ReportingPeriod, PeriodComparison, PeriodSummaryProps, } from './ui/PeriodSummary.js';
 export { createDataContext } from './ui/data-context.js';
@@ -66,5 +66,5 @@ export { AnnotationTarget } from './annotations/AnnotationTarget.js';
 export type { AnnotationTargetProps } from './annotations/AnnotationTarget.js';
 export { useDataAppAnnotations } from './annotations/useDataAppAnnotations.js';
 export { AnnotationBar } from './annotations/AnnotationBar.js';
-export type { AnnotationBarProps } from './annotations/AnnotationBar.js';
+export type { AnnotationBarHandle, AnnotationBarProps, } from './annotations/AnnotationBar.js';
 export { injectDataAppAnnotationStyles } from './annotations/styles.js';

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

@@ -1,11 +1,13 @@
 import { type ComponentType, type ReactNode } from 'react';
-import { type DataAppConfig } from '../core/config.js';
+import { type DataAppDefinition, type QueryDefinitions } from '../core/config.js';
 /** Mount once per document; installs document identity and the shared request provider. */
-export declare function mountDataApp({ config, component: Component, root, }: {
-    config: DataAppConfig;
+export declare function mountDataApp<const Queries extends QueryDefinitions>({ app, component: Component, root, }: {
+    app: DataAppDefinition<Queries>;
     component: ComponentType;
     root?: HTMLElement | null;
 }): void;
-export declare function DataAppProvider({ children }: {
+/** Provide one app identity and shared requests to a custom React root. */
+export declare function DataAppProvider<const Queries extends QueryDefinitions>({ app, children, }: {
+    app: DataAppDefinition<Queries>;
     children: ReactNode;
 }): import("react").JSX.Element;

package/dist/types/react/style-contract.d.ts

@@ -1,6 +1,6 @@
 import type { CSSProperties } from 'react';
 /** Public custom-property names for authoring types and validation. CSS owns their defaults. */
-export declare const dataAppStyleTokens: readonly ['--atbl-annotation-accent', '--atbl-annotation-accent-hover', '--atbl-annotation-on-accent', '--atbl-annotation-highlight', '--atbl-background', '--atbl-surface', '--atbl-subtle', '--atbl-text', '--atbl-muted', '--atbl-border', '--atbl-accent', '--atbl-accent-subtle', '--atbl-on-accent', '--atbl-positive', '--atbl-negative', '--atbl-danger', '--atbl-danger-subtle', '--atbl-backdrop', '--atbl-code-surface', '--atbl-code-text', '--atbl-code-keyword', '--atbl-chart-fill', '--atbl-control-hover-border', '--atbl-focus-color', '--atbl-focus-outline', '--atbl-focus-ring-offset', '--atbl-focus-ring-inset', '--atbl-font', '--atbl-font-heading', '--atbl-mono-font', '--atbl-space-xs', '--atbl-space-sm', '--atbl-space-md', '--atbl-space-lg', '--atbl-space-xl', '--atbl-layout-gap', '--atbl-content-width', '--atbl-control-height', '--atbl-radius-control', '--atbl-radius-surface', '--atbl-radius-overlay', '--atbl-shadow-surface', '--atbl-shadow-overlay', '--atbl-shadow-control', '--atbl-cursor-action', '--atbl-cursor-disabled', '--atbl-cursor-help', '--atbl-duration-fast', '--atbl-duration-normal', '--atbl-duration-slow', '--atbl-ease-standard', '--atbl-ease-enter', '--atbl-chart-1', '--atbl-chart-2', '--atbl-chart-3', '--atbl-chart-4', '--atbl-chart-5', '--atbl-chart-6', '--atbl-chart-7', '--atbl-chart-8', '--atbl-type-emphasis-weight', '--atbl-type-meta-weight', '--atbl-type-page-size', '--atbl-type-section-size', '--atbl-type-widget-size', '--atbl-type-body-size', '--atbl-type-label-size', '--atbl-type-meta-size', '--atbl-type-metric-size', '--atbl-type-heading-weight', '--atbl-type-label-weight', '--atbl-type-body-leading', '--atbl-type-label-leading', '--atbl-type-heading-leading', '--atbl-type-metric-leading', '--atbl-text-measure', '--atbl-control-compact-height', '--atbl-control-icon-size', '--atbl-control-padding-inline', '--atbl-control-padding-block', '--atbl-control-gap', '--atbl-control-disabled-opacity', '--atbl-cursor-busy', '--atbl-control-hover-surface', '--atbl-control-pressed-surface', '--atbl-control-selected-surface', '--atbl-control-selected-text'];
+export declare const dataAppStyleTokens: readonly ['--atbl-control-text-size', '--atbl-annotation-accent', '--atbl-annotation-accent-hover', '--atbl-annotation-on-accent', '--atbl-annotation-highlight', '--atbl-background', '--atbl-surface', '--atbl-subtle', '--atbl-text', '--atbl-muted', '--atbl-border', '--atbl-accent', '--atbl-accent-subtle', '--atbl-on-accent', '--atbl-positive', '--atbl-negative', '--atbl-danger', '--atbl-danger-subtle', '--atbl-backdrop', '--atbl-code-surface', '--atbl-code-text', '--atbl-code-keyword', '--atbl-chart-fill', '--atbl-control-hover-border', '--atbl-focus-color', '--atbl-focus-outline', '--atbl-focus-ring-offset', '--atbl-focus-ring-inset', '--atbl-font', '--atbl-font-heading', '--atbl-mono-font', '--atbl-space-xs', '--atbl-space-sm', '--atbl-space-md', '--atbl-space-lg', '--atbl-space-xl', '--atbl-layout-gap', '--atbl-content-width', '--atbl-control-height', '--atbl-radius-control', '--atbl-radius-surface', '--atbl-radius-overlay', '--atbl-shadow-surface', '--atbl-shadow-overlay', '--atbl-shadow-control', '--atbl-cursor-action', '--atbl-cursor-disabled', '--atbl-cursor-help', '--atbl-duration-fast', '--atbl-duration-normal', '--atbl-duration-slow', '--atbl-ease-standard', '--atbl-ease-enter', '--atbl-chart-1', '--atbl-chart-2', '--atbl-chart-3', '--atbl-chart-4', '--atbl-chart-5', '--atbl-chart-6', '--atbl-chart-7', '--atbl-chart-8', '--atbl-type-emphasis-weight', '--atbl-type-meta-weight', '--atbl-type-page-size', '--atbl-type-section-size', '--atbl-type-widget-size', '--atbl-type-body-size', '--atbl-type-label-size', '--atbl-type-meta-size', '--atbl-type-metric-size', '--atbl-type-heading-weight', '--atbl-type-label-weight', '--atbl-type-body-leading', '--atbl-type-label-leading', '--atbl-type-heading-leading', '--atbl-type-metric-leading', '--atbl-text-measure', '--atbl-control-compact-height', '--atbl-control-icon-size', '--atbl-control-padding-inline', '--atbl-control-padding-block', '--atbl-control-gap', '--atbl-control-disabled-opacity', '--atbl-cursor-busy', '--atbl-control-hover-surface', '--atbl-control-pressed-surface', '--atbl-control-selected-surface', '--atbl-control-selected-text'];
 /** Stable component roots for CSS customization; only utilities may be placed on native markup. */
 export declare const dataAppStyleClasses: {
     readonly 'altertable-app-layout': {
@@ -43,6 +43,38 @@ export declare const dataAppStyleClasses: {
         readonly component: 'DataAppSkeleton';
         readonly kind: 'root';
     };
+    readonly 'altertable-chart-legend': {
+        readonly component: 'ChartLegend';
+        readonly kind: 'root';
+    };
+    readonly 'altertable-chart-legend-item': {
+        readonly component: 'ChartLegend.Item';
+        readonly kind: 'root';
+    };
+    readonly 'altertable-chart-legend-marker': {
+        readonly component: 'ChartLegend.Marker';
+        readonly kind: 'root';
+    };
+    readonly 'altertable-chart-legend-label': {
+        readonly component: 'ChartLegend.Label';
+        readonly kind: 'root';
+    };
+    readonly 'altertable-funnel-chart': {
+        readonly component: 'FunnelChart';
+        readonly kind: 'root';
+    };
+    readonly 'altertable-retention-chart': {
+        readonly component: 'RetentionChart';
+        readonly kind: 'root';
+    };
+    readonly 'altertable-journey-chart': {
+        readonly component: 'JourneyChart';
+        readonly kind: 'root';
+    };
+    readonly 'altertable-composed-chart': {
+        readonly component: 'ComposedChart';
+        readonly kind: 'root';
+    };
     readonly 'altertable-sr-only': {
         readonly component: null;
         readonly kind: 'utility';
@@ -50,7 +82,7 @@ export declare const dataAppStyleClasses: {
 };
 export declare const dataAppStyleHooks: {
     readonly 'data-atbl-focus': readonly ['ring', 'inset', 'group'];
-    readonly 'data-atbl-control': readonly ['action', 'help', 'text'];
+    readonly 'data-atbl-control': readonly ['default', 'action', 'help', 'text'];
 };
 export type DataAppStyleToken = (typeof dataAppStyleTokens)[number];
 /** React style properties with checked public Altertable custom properties. */

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

@@ -1,11 +1,11 @@
 import type { ComponentPropsWithRef } from 'react';
-import { type ButtonProps as AriaButtonProps } from 'react-aria-components';
+import { Button as AriaButton } from 'react-aria-components';
 export type ButtonProps = ComponentPropsWithRef<'button'> & {
-    variant?: 'elevated' | 'outline' | 'ghost';
+    variant?: 'primary' | 'elevated' | 'outline' | 'ghost';
     size?: 'default' | 'compact' | 'icon' | 'icon-compact';
 };
 export declare function Button({ className, type, variant, size, disabled, ...props }: ButtonProps): import("react").JSX.Element;
 /** React Aria trigger behavior with the same presentation as the native Button. */
-export declare function PressButton({ variant, size, className, ...props }: Omit<AriaButtonProps, 'className'> & Pick<ButtonProps, 'variant' | 'size'> & {
+export declare function PressButton({ variant, size, className, ...props }: Omit<ComponentPropsWithRef<typeof AriaButton>, 'className'> & Pick<ButtonProps, 'variant' | 'size'> & {
     className?: string;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,31 @@
+import { type ComponentPropsWithRef, type ReactNode } from 'react';
+export type ChartLegendProps = {
+    children: ReactNode;
+    layout?: 'horizontal' | 'vertical';
+    align?: 'start' | 'center' | 'end';
+    /** Maximum visible cells, including the expansion control; defaults to six. */
+    maxVisibleItems?: number;
+} & Omit<ComponentPropsWithRef<'ul'>, 'children'>;
+/** Optional chart key, placed beside any chart with the app's layout components.
+ * Items describe displayed series or categories; the caller owns series visibility and interactions. */
+declare function ChartLegendRoot({ children, layout, align, maxVisibleItems, className, 'aria-label': ariaLabel, ...props }: ChartLegendProps): import("react").JSX.Element;
+export type ChartLegendItemProps = ComponentPropsWithRef<'li'> & {
+    inactive?: boolean;
+};
+/** Descriptive by default; compose a button inside the item for an authored series toggle. */
+declare function ChartLegendItem({ inactive, className, ...props }: ChartLegendItemProps): import("react").JSX.Element;
+export type ChartLegendMarkerKind = 'square' | 'bar' | 'line' | 'area' | 'point' | 'slice';
+export type ChartLegendMarkerProps = Omit<ComponentPropsWithRef<'svg'>, 'children'> & {
+    kind: ChartLegendMarkerKind;
+};
+/** Decorative mark; color accepts public palette tokens or any CSS color.
+ * Defaults match the shared bar or accent-colored series primitives. */
+declare function ChartLegendMarker({ kind, color, className, style, ...props }: ChartLegendMarkerProps): import("react").JSX.Element;
+export type ChartLegendLabelProps = ComponentPropsWithRef<'span'>;
+declare function ChartLegendLabel({ className, children, title, ...props }: ChartLegendLabelProps): import("react").JSX.Element;
+export declare const ChartLegend: typeof ChartLegendRoot & {
+    Item: typeof ChartLegendItem;
+    Marker: typeof ChartLegendMarker;
+    Label: typeof ChartLegendLabel;
+};
+export {};

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

@@ -1,10 +1,21 @@
 import { type ReactNode } from 'react';
+export declare const CheckboxGroupContext: import("react").Context<{
+    values: readonly string[];
+    disabled?: boolean;
+    onChange: (value: string, checked: boolean) => void;
+} | null>;
 export type CheckboxProps = {
     label: string;
     description?: ReactNode;
-    checked: boolean;
-    onChange: (checked: boolean) => void;
     disabled?: boolean;
     className?: string;
-};
-export declare function Checkbox({ label, description, checked, onChange, disabled, className, }: CheckboxProps): import("react").JSX.Element;
+} & ({
+    value: string;
+    checked?: never;
+    onChange?: never;
+} | {
+    value?: never;
+    checked: boolean;
+    onChange: (checked: boolean) => void;
+});
+export declare function Checkbox({ label, description, checked, value, onChange, disabled, className, }: CheckboxProps): import("react").JSX.Element;

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

@@ -0,0 +1,7 @@
+import type { ComponentPropsWithRef } from 'react';
+export type CheckboxGroupProps = Omit<ComponentPropsWithRef<'fieldset'>, 'onChange'> & {
+    label: string;
+    values: readonly string[];
+    onChange: (values: string[]) => void;
+};
+export declare function CheckboxGroup({ label, values, onChange, className, children, disabled, ...props }: CheckboxGroupProps): import("react").JSX.Element;

package/dist/types/react/ui/{Combobox.d.ts → ChoicePicker.d.ts}

@@ -1,14 +1,10 @@
-/** IDs are nonempty and unique across ordinary and missing options. */
-export type ComboboxOption = {
-    id: string;
-    label: string;
-    description?: string;
-};
+import type { ChoiceOption } from '../../core/variables.js';
+export type { ChoiceOption } from '../../core/variables.js';
 type SharedProps = {
     label: string;
-    options: ComboboxOption[];
+    options: readonly ChoiceOption[];
     /** Separate source state, rendered last with a divider and the shared option component. */
-    missingOption?: ComboboxOption;
+    missingOption?: ChoiceOption;
     disabled?: boolean;
     placeholder?: string;
     emptyMessage?: string;
@@ -18,15 +14,16 @@ type SharedProps = {
     error?: boolean;
     onRetry?: () => void;
 };
-export type SingleComboboxProps = SharedProps & {
+export type SingleChoicePickerProps = SharedProps & {
+    selectionMode: 'single';
     value: string;
     onChange: (value: string) => void;
-    resetValue?: string;
     values?: never;
     maxSelected?: never;
     emptySelectionLabel?: never;
 };
-export type MultiComboboxProps = SharedProps & {
+export type MultiChoicePickerProps = SharedProps & {
+    selectionMode: 'multiple';
     values: readonly string[];
     onChange: (values: string[]) => void;
     /** Positive integer; at capacity, only unselected options are disabled. */
@@ -34,9 +31,7 @@ export type MultiComboboxProps = SharedProps & {
     /** Meaning of an empty selection belongs to the caller, e.g. All or Select a value. */
     emptySelectionLabel: string;
     value?: never;
-    resetValue?: never;
 };
-export type ComboboxProps = SingleComboboxProps | MultiComboboxProps;
+export type ChoicePickerProps = SingleChoicePickerProps | MultiChoicePickerProps;
 /** Searchable selection picker with one focus and popup model for single and multiple values. */
-export declare function Combobox(props: ComboboxProps): import("react").JSX.Element;
-export {};
+export declare function ChoicePicker(props: ChoicePickerProps): import("react").JSX.Element;

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

@@ -0,0 +1,41 @@
+import { type ComponentProps } from 'react';
+import { ComposedChartLegend as Legend } from './ComposedChartLegend.js';
+import { ComposedChart as RechartsComposedChart, ZAxis, ReferenceLine, ReferenceArea, ReferenceDot, Brush, Label, LabelList, ErrorBar } from 'recharts';
+import { ChartBar as Bar, ChartDot as Dot, ChartLine as Line, ChartArea as Area, ChartScatter as Scatter, ChartXAxis as XAxis, ChartYAxis as YAxis, ChartGrid as CartesianGrid, ChartTooltip as Tooltip } from './chart-primitives.js';
+export type ComposedChartProps<Row = unknown> = Omit<ComponentProps<typeof RechartsComposedChart<Row>>, 'data' | 'title'> & {
+    /** Displayed rows; series and axes select fields with Recharts dataKey props. */
+    data: readonly Row[];
+    /** Describes the measures and scope for assistive technology. */
+    ariaLabel: string;
+};
+/** Compose Cartesian series inside VisualizationWidget. Defaults to responsive
+ * full width and 300px height. Children retain native Recharts props and behavior,
+ * including stacking, numeric/time axes, missing values, tooltips, and keyboard
+ * navigation. Match yAxisId on axes and series for different units; use stackId
+ * for stacks. Preserve missing measures as null and choose connectNulls deliberately.
+ * Use public chart tokens for series colors. Dataset bindings own
+ * loading, empty results, evidence, and CSV; this primitive owns only the plot. */
+declare function ComposedChartRoot<Row>({ data, ariaLabel, width, height, responsive, className, ...props }: ComposedChartProps<Row>): import("react").JSX.Element;
+/** Shared themed series and controls; other children retain native Recharts defaults. */
+export declare const ComposedChart: typeof ComposedChartRoot & {
+    Dot: typeof Dot;
+    Area: typeof Area;
+    Bar: typeof Bar;
+    Line: typeof Line;
+    Scatter: typeof Scatter;
+    XAxis: typeof XAxis;
+    YAxis: typeof YAxis;
+    ZAxis: typeof ZAxis;
+    CartesianGrid: typeof CartesianGrid;
+    Tooltip: typeof Tooltip;
+    Legend: typeof Legend;
+    ReferenceLine: typeof ReferenceLine;
+    ReferenceArea: typeof ReferenceArea;
+    ReferenceDot: typeof ReferenceDot;
+    Brush: typeof Brush;
+    Cell: import("react").FunctionComponent<import("recharts").CellProps>;
+    Label: typeof Label;
+    LabelList: typeof LabelList;
+    ErrorBar: typeof ErrorBar;
+};
+export {};

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

@@ -0,0 +1,8 @@
+import type { ComponentProps } from 'react';
+import { Legend } from 'recharts';
+export type ComposedChartLegendProps = ComponentProps<typeof Legend> & {
+    maxVisibleItems?: number;
+};
+/** Opt in inside ComposedChart to derive the shared legend from its displayed series.
+ * Native positioning, sorting, formatters, callbacks, and custom content remain available. */
+export declare function ComposedChartLegend({ maxVisibleItems, ...props }: ComposedChartLegendProps): import("react").JSX.Element;

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

@@ -1,6 +1,5 @@
 import { type ReactNode } from 'react';
 import type { DisclosedQuery } from '../../core/contract.js';
-import type { DataAppConfig } from '../../core/config.js';
 import type { CsvExport } from './csv-export.js';
 import { type DisplayedSnapshot } from '../../core/data-view.js';
 import type { DataContext } from './data-context.js';
@@ -8,8 +7,8 @@ import type { BoundStory } from './story.js';
 import type { SectionResult } from './DataSectionBoundary.js';
 export type DataAppBaseProps = {
     children: ReactNode;
-    config: DataAppConfig;
     dataContext: DataContext;
+    /** Override the declared subtitle; null hides it. */
     description?: ReactNode;
     toolbarActions?: ReactNode;
     footerActions?: ReactNode;

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

@@ -1,5 +1,5 @@
 import type { DimensionOption, DimensionSelection, DimensionValue, DimensionVariable } from '../../core/dimension.js';
-/** Adapts the typed dimension contract to the shared Combobox control. */
+/** Adapts the typed dimension contract to the shared ChoicePicker control. */
 export declare function DimensionPicker<T extends DimensionValue>({ filter, value, onChange, options: suppliedOptions, loading, error, onRetry, }: {
     filter: DimensionVariable<T>;
     value: DimensionSelection<T>;

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

@@ -0,0 +1,10 @@
+export type FilterActionsProps = {
+    onClear?: () => void;
+} & ({
+    onApply: () => void;
+    onCancel: () => void;
+} | {
+    onApply?: never;
+    onCancel?: never;
+});
+export declare function FilterActions({ onClear, onApply, onCancel, }: FilterActionsProps): import("react").JSX.Element;

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

@@ -0,0 +1,3 @@
+import type { ComponentPropsWithRef } from 'react';
+export type FilterBarProps = ComponentPropsWithRef<'div'>;
+export declare function FilterBar({ className, role, 'aria-label': label, ...props }: FilterBarProps): import("react").JSX.Element;

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

@@ -0,0 +1,20 @@
+import type { CountChartProps } from './chart-data.js';
+/** Ordered step with a unique, nonblank ID. */
+export type FunnelChartStep = {
+    id: string;
+    label: string;
+};
+export type FunnelChartSeries = {
+    /** Unique, nonblank population ID. */
+    id: string;
+    label: string;
+    /** Finite, nonnegative counts aligned with steps and nonincreasing. */
+    values: readonly number[];
+};
+export type FunnelChartProps = CountChartProps & {
+    steps: readonly FunnelChartStep[];
+    series: readonly FunnelChartSeries[];
+};
+/** Conversion columns with previous-step drop-off, normalized to each series' first step.
+ * Owns series highlighting and portion-specific inspection; compose inside VisualizationWidget. */
+export declare function FunnelChart({ steps, series, unit, ariaLabel, className, formatValue, }: FunnelChartProps): import("react").JSX.Element;

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

@@ -1,8 +1,6 @@
-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, }: {
-    config: DataAppConfig;
+ * `DataAppProvider` and register `connection: connectionCheck(app.queries)` on the server. */
+export declare function GettingStarted({ dataContext }: {
     dataContext: DataContext;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,10 @@
+import type { CountChartProps } from './chart-data.js';
+import { type JourneyChartPath } from './journey-flow.js';
+export type { JourneyChartPath } from './journey-flow.js';
+export type JourneyChartProps = CountChartProps & {
+    /** Full paths and their population counts. Branches and outcomes are derived internally. */
+    paths: readonly JourneyChartPath[];
+};
+/** Path exploration with two initial steps, expandable prefixes, and three events per depth.
+ * Counts and flows use the Step 1 population. Compose inside VisualizationWidget. */
+export declare function JourneyChart({ paths, unit, ariaLabel, className, formatValue, }: JourneyChartProps): import("react").JSX.Element;

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

@@ -0,0 +1,12 @@
+import type { ComponentPropsWithRef } from 'react';
+import { MenuTrigger, MenuSection, Popover, Separator, type MenuProps, type MenuItemProps, type MenuTriggerProps } from 'react-aria-components';
+export { MenuTrigger, MenuSection };
+export { PressButton as MenuButton } from './Button.js';
+export type { MenuProps, MenuItemProps, MenuTriggerProps };
+export type MenuPopoverProps = ComponentPropsWithRef<typeof Popover>;
+/** Anchored popup for a Menu; the surrounding MenuTrigger owns focus and dismissal. */
+export declare function MenuPopover({ className, placement, ...props }: MenuPopoverProps): import("react").JSX.Element;
+/** Actions by default; single selection creates radio items, multiple creates checkbox items. */
+export declare function Menu<T extends object>({ className, ...props }: MenuProps<T>): import("react").JSX.Element;
+export declare function MenuItem<T extends object>({ className, children, ...props }: MenuItemProps<T>): import("react").JSX.Element;
+export declare function MenuSeparator({ className, ...props }: ComponentPropsWithRef<typeof Separator>): import("react").JSX.Element;

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

@@ -0,0 +1,27 @@
+import type { ComponentPropsWithRef } from 'react';
+import { NumberField as AriaNumberField } from 'react-aria-components';
+export type NumberFieldProps = Omit<ComponentPropsWithRef<typeof AriaNumberField>, 'value' | 'onChange' | 'className'> & {
+    label: string;
+    value: number | null;
+    onChange: (value: number | null) => void;
+    className?: string;
+};
+/** Localized numeric entry. Empty input is null rather than zero. */
+export declare function NumberField({ label, value, onChange, className, ...props }: NumberFieldProps): import("react").JSX.Element;
+export type NumberRange = {
+    min?: number;
+    max?: number;
+};
+export type NumberRangeFieldProps = {
+    label: string;
+    value: NumberRange;
+    onChange: (value: NumberRange) => void;
+    /** Reports whether the current draft interval can be committed. */
+    onValidityChange?: (valid: boolean) => void;
+    min?: number;
+    max?: number;
+    disabled?: boolean;
+    className?: string;
+};
+/** Commit valid intervals; retain invalid draft bounds so users can correct them. */
+export declare function NumberRangeField({ label, value, onChange, onValidityChange, min, max, disabled, className, }: NumberRangeFieldProps): import("react").JSX.Element;

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

@@ -0,0 +1,9 @@
+import { type NumberFilter, type NumberSelection } from '../../core/filters.js';
+export type NumberFilterPickerProps = {
+    filter: NumberFilter;
+    value: NumberSelection;
+    onChange: (value: NumberSelection) => void;
+    disabled?: boolean;
+};
+/** Edit a numeric predicate in a panel. Apply commits one complete value; dismissing discards the draft. */
+export declare function NumberFilterPicker({ filter, value, onChange, disabled, }: NumberFilterPickerProps): import("react").JSX.Element;