@altertable/data-app 0.66.0 → 0.68.0

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

@@ -1,8 +1,11 @@
 import type { ChartItem, ValueChartProps } from './chart-data.js';
 export type PieChartItem = ChartItem;
-export type PieChartProps = ValueChartProps;
+export type PieChartProps = ValueChartProps & {
+    /** Omit the built-in key when composing a separate ChartLegend. */
+    showLegend?: boolean;
+};
 /** 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;
+export declare function PieChart({ items, unit, ariaLabel, showLegend, formatValue, }: PieChartProps): import("react").JSX.Element;

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

@@ -0,0 +1,18 @@
+import type { ComponentPropsWithRef, ReactNode } from 'react';
+import { RadioGroup as AriaRadioGroup, Radio as AriaRadio } from 'react-aria-components';
+import { type ChoiceOption } from '../../core/variables.js';
+export type RadioGroupProps = Omit<ComponentPropsWithRef<typeof AriaRadioGroup>, 'className' | 'children'> & {
+    children: ReactNode;
+    label: string;
+    className?: string;
+};
+export declare function RadioGroup({ label, className, children, ...props }: RadioGroupProps): import("react").JSX.Element;
+export type RadioProps = Omit<ComponentPropsWithRef<typeof AriaRadio>, 'className'> & {
+    className?: string;
+};
+export declare function Radio({ className, children, ...props }: RadioProps): import("react").JSX.Element;
+export type SegmentedControlProps = Omit<RadioGroupProps, 'children'> & {
+    options: readonly ChoiceOption[];
+};
+/** A compact radio group; arrow keys follow standard radio selection behavior. */
+export declare function SegmentedControl({ options, className, ...props }: SegmentedControlProps): import("react").JSX.Element;

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

@@ -0,0 +1,27 @@
+import type { CountChartProps } from './chart-data.js';
+export type RetentionChartPoint = {
+    /** Nonnegative integer, unique per series; uneven offsets retain their distance. */
+    offset: number;
+    /** Must agree across series for the same offset. */
+    label: string;
+    /** Observed retention fraction in [0, 1], or null for an unobserved period. */
+    rate: number | null;
+    /** Finite count in [0, cohortSize]; null exactly when rate is null. */
+    retainedCount: number | null;
+    /** Observed but still accumulating; drawn as a dotted tail. */
+    incomplete?: boolean;
+};
+export type RetentionChartSeries = {
+    /** Unique, nonblank cohort or segment ID. */
+    id: string;
+    label: string;
+    /** Finite, nonnegative starting population. */
+    cohortSize: number;
+    points: readonly RetentionChartPoint[];
+};
+export type RetentionChartProps = CountChartProps & {
+    series: readonly RetentionChartSeries[];
+};
+/** Query-defined retention curves with count inspection and dotted incomplete periods.
+ * Rates are not recomputed from counts. Compose inside VisualizationWidget. */
+export declare function RetentionChart({ series, unit, ariaLabel, className, formatValue, }: RetentionChartProps): import("react").JSX.Element;

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

@@ -1,8 +1,8 @@
 import type { ComponentPropsWithRef, ReactNode } from 'react';
 /** One search control surface for picker search and table/page search. */
-export declare function SearchInput({ focusRing, size, endAction, loading, className, onKeyDown, ...props }: Omit<ComponentPropsWithRef<'input'>, 'size' | 'children'> & {
+export declare function SearchInput({ focusRing, size, endAction, loading, className, ...props }: Omit<ComponentPropsWithRef<'input'>, 'size' | 'children'> & {
     size?: 'default' | 'compact';
-    /** Menu search delegates focus indication to the active option. */
+    /** Picker 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. */

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

@@ -0,0 +1,14 @@
+import { type ChoiceOption } from '../../core/variables.js';
+export type SelectProps = {
+    label: string;
+    options: readonly ChoiceOption[];
+    value: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+    required?: boolean;
+    name?: string;
+    id?: string;
+    className?: string;
+};
+/** Labeled single selection with keyboard navigation and a styled listbox. */
+export declare function Select({ label, options, value, onChange, disabled, required, className, ...props }: SelectProps): import("react").JSX.Element;

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

@@ -1,4 +1,5 @@
 /** Decorative selection indicator; the containing control owns its accessible semantics. */
-export declare function SelectionMark({ selected }: {
+export declare function SelectionMark({ selected, multiple, }: {
     selected: boolean;
+    multiple?: boolean;
 }): import("react").JSX.Element;

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

@@ -0,0 +1,3 @@
+import type { ComponentPropsWithRef } from 'react';
+/** Shared surface for floating hints and chart value inspection. */
+export declare function TooltipSurface({ className, ...props }: ComponentPropsWithRef<'span'>): import("react").JSX.Element;

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

@@ -11,6 +11,15 @@ export type ValueChartProps = {
     ariaLabel: string;
     formatValue?: (value: number) => string;
 };
+export type CountChartProps = {
+    /** Accessible measure and scope description. */
+    ariaLabel: string;
+    /** Population unit, such as users or sessions. */
+    unit: string;
+    /** Formats counts; rates use percentage formatting. */
+    formatValue?: (value: number) => string;
+    className?: string;
+};
 /** Independent observation on two finite numeric axes. */
 export type ScatterChartItem = {
     id: string;
@@ -20,6 +29,6 @@ export type ScatterChartItem = {
 };
 type ChartKind = 'bar' | 'line' | 'area' | 'pie' | 'scatter';
 type ItemFor<Kind extends ChartKind> = Kind extends 'scatter' ? ScatterChartItem : ChartItem;
-/** Validate the data consumed by every chart. */
+/** Validate standalone item-based chart inputs. */
 export declare function validateChartItems<Kind extends ChartKind>(kind: Kind, items: readonly ItemFor<Kind>[]): void;
 export {};

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

@@ -0,0 +1,22 @@
+import type { ComponentProps } from 'react';
+import { type DotProps, Scatter, XAxis, YAxis, CartesianGrid, Tooltip, DefaultTooltipContent, type BarProps, type LineProps, type AreaProps } from 'recharts';
+/** Hollow sample marker shared by standalone and composed series. */
+export declare function ChartDot({ active, stroke, fill, r, ...props }: DotProps & {
+    active?: boolean;
+}): import("react").JSX.Element;
+/** Shared series defaults; native props override every authored choice. */
+export declare function ChartBar<Row = unknown, Value = number | null>(props: BarProps<Row, Value>): import("react").JSX.Element;
+/** Themed hollow sample dots are enabled by default; dot=false hides them.
+ * activeDot independently controls the hovered point. Native dot props and renderers remain available. */
+export declare function ChartLine<Row = unknown, Value = number | null>({ stroke, dot, activeDot, ...props }: LineProps<Row, Value>): import("react").JSX.Element;
+/** Filled series with the same sample-dot and activeDot options as ChartLine. */
+export declare function ChartArea<Row = unknown, Value = number | null>({ stroke, dot, activeDot, ...props }: AreaProps<Row, Value>): import("react").JSX.Element;
+export declare function ChartScatter<Row = unknown, Value = number>(props: ComponentProps<typeof Scatter<Row, Value>>): import("react").JSX.Element;
+export declare function ChartXAxis<Row = unknown, Value = string | number>(props: ComponentProps<typeof XAxis<Row, Value>>): import("react").JSX.Element;
+export declare function ChartYAxis<Row = unknown, Value = number>(props: ComponentProps<typeof YAxis<Row, Value>>): import("react").JSX.Element;
+export declare function ChartGrid(props: ComponentProps<typeof CartesianGrid>): import("react").JSX.Element;
+export declare function ChartTooltipContent(props: ComponentProps<typeof DefaultTooltipContent> & {
+    active?: boolean;
+}): import("react").JSX.Element | null;
+/** Uses the same surface as single-series inspection; Recharts owns interaction. */
+export declare function ChartTooltip(props: ComponentProps<typeof Tooltip>): import("react").JSX.Element;

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

@@ -1 +1,2 @@
 export declare function chartColor(id: string): string;
+export declare const chartBarFill = "var(--atbl-chart-fill, color-mix(in srgb, var(--atbl-accent) 75%, var(--atbl-surface)))";

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

@@ -18,6 +18,7 @@ declare const brandedIcons: {
     readonly export: import("lucide-react").LucideIcon;
     readonly error: import("lucide-react").LucideIcon;
     readonly close: import("lucide-react").LucideIcon;
+    readonly clearFilters: import("lucide-react").LucideIcon;
     readonly previous: import("lucide-react").LucideIcon;
     readonly next: import("lucide-react").LucideIcon;
     readonly lightTheme: import("lucide-react").LucideIcon;

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

@@ -1,6 +1,7 @@
 /** Direct UI composition and static screens. Requests use declared views from /react. */
 export { injectDataAppShellStyles } from '../shellStyles.js';
 export { DataAppProvider } from '../mount.js';
+export { isPlainKeyEvent } from './keyboard.js';
 export { GettingStarted } from './GettingStarted.js';
 export { DataWidget } from './DataWidget.js';
 export type { WidgetStatus } from './RequestHint.js';
@@ -29,8 +30,10 @@ 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 { ChoicePicker } from './ChoicePicker.js';
+export type { ChoiceOption, ChoicePickerProps, } from './ChoicePicker.js';
+export { MenuTrigger, MenuButton, MenuPopover, Menu, MenuItem, MenuSection, MenuSeparator, } from './Menu.js';
+export type { MenuTriggerProps, MenuPopoverProps, MenuProps, MenuItemProps, } from './Menu.js';
 export { GradientScroll } from './GradientScroll.js';
 export type { GradientScrollProps } from './GradientScroll.js';
 export { Tabs, TabList, Tab, TabPanels, TabPanel, useViewTab, } from './Tabs.js';
@@ -72,3 +75,31 @@ 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';
+export { Select } from './Select.js';
+export type { SelectProps } from './Select.js';
+export { RadioGroup, Radio, SegmentedControl } from './RadioGroup.js';
+export type { RadioGroupProps, RadioProps, SegmentedControlProps, } from './RadioGroup.js';
+export { CheckboxGroup } from './CheckboxGroup.js';
+export type { CheckboxGroupProps } from './CheckboxGroup.js';
+export { NumberField, NumberRangeField } from './NumberField.js';
+export type { NumberFieldProps, NumberRangeFieldProps, NumberRange, } from './NumberField.js';
+export { FilterBar } from './FilterBar.js';
+export type { FilterBarProps } from './FilterBar.js';
+export { VariableBar } from './VariableBar.js';
+export type { VariableBarProps } from './VariableBar.js';
+export { FilterActions } from './FilterActions.js';
+export type { FilterActionsProps } from './FilterActions.js';
+export { NumberFilterPicker } from './NumberFilterPicker.js';
+export type { NumberFilterPickerProps } from './NumberFilterPicker.js';
+export { ComposedChart } from './ComposedChart.js';
+export type { ComposedChartProps } from './ComposedChart.js';
+export { ChartLegend } from './ChartLegend.js';
+export type { ChartLegendProps, ChartLegendItemProps, ChartLegendMarkerProps, ChartLegendLabelProps, ChartLegendMarkerKind, } from './ChartLegend.js';
+export type { ComposedChartLegendProps } from './ComposedChartLegend.js';
+export { FunnelChart } from './FunnelChart.js';
+export type { FunnelChartProps, FunnelChartStep, FunnelChartSeries, } from './FunnelChart.js';
+export { RetentionChart } from './RetentionChart.js';
+export type { RetentionChartProps, RetentionChartPoint, RetentionChartSeries, } from './RetentionChart.js';
+export { JourneyChart } from './JourneyChart.js';
+export type { JourneyChartProps, JourneyChartPath, } from './JourneyChart.js';
+export { useSvgId } from './useSvgId.js';

package/dist/types/react/ui/journey-flow.d.ts

@@ -0,0 +1,49 @@
+/** Aggregated route; repeated events remain distinct by depth and prefix. */
+export type JourneyChartPath = {
+    /** Unique, nonblank path ID. */
+    id: string;
+    /** At least one nonblank event; null property means no property grouping. */
+    steps: readonly {
+        event: string;
+        property: string | null;
+    }[];
+    /** Finite, nonnegative population following this route. */
+    count: number;
+    /** True: converted; false: dropped off; null: no conversion classification. */
+    converted: boolean | null;
+    /** Stops at the last loaded event, without adding an outcome or expand control. */
+    truncated: boolean;
+};
+export type JourneyNode = {
+    key: string;
+    label: string;
+    depth: number;
+    outcome: 'event' | 'converted' | 'drop-off' | 'truncated' | 'end' | 'other';
+    count: number;
+    pathKeys: string[];
+    branchKeys?: string[];
+    expandable?: boolean;
+    expanded?: boolean;
+    hiddenBranchCount?: number;
+};
+export declare function journeyNodes(path: JourneyChartPath): Omit<JourneyNode, 'count' | 'pathKeys'>[];
+export declare function buildJourneyFlow(paths: readonly JourneyChartPath[], expandedBranch?: string[]): {
+    nodes: JourneyNode[];
+    links: {
+        key: string;
+        source: string;
+        target: string;
+        count: number;
+        pathKeys: string[];
+    }[];
+};
+export declare function limitJourneyFlow(graph: ReturnType<typeof buildJourneyFlow>, visibleEventsByDepth?: Record<number, number>): {
+    nodes: JourneyNode[];
+    links: {
+        key: string;
+        source: string;
+        target: string;
+        count: number;
+        pathKeys: string[];
+    }[];
+};

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

@@ -0,0 +1,6 @@
+type KeyEvent = Pick<KeyboardEvent, 'altKey' | 'ctrlKey' | 'metaKey' | 'shiftKey' | 'isComposing'>;
+/** Keep local key actions separate from shortcuts and IME composition. Pass React's nativeEvent. */
+export declare function isPlainKeyEvent(event: KeyEvent, { allowShift }?: {
+    allowShift?: boolean;
+}): boolean;
+export {};

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

@@ -15,6 +15,11 @@ export declare const shortcuts: {
         readonly code: 'Period';
         readonly key: '.';
     };
+    readonly sendAnnotations: {
+        readonly modifier: 'mod';
+        readonly code: 'Enter';
+        readonly key: 'Enter';
+    };
     readonly refresh: {
         readonly modifier: 'alt';
         readonly code: 'KeyR';
@@ -27,6 +32,7 @@ export declare const shortcuts: {
     };
     readonly playStory: {
         readonly modifier: 'mod';
+        readonly shift: true;
         readonly code: 'Enter';
         readonly key: 'Enter';
     };
@@ -34,5 +40,6 @@ export declare const shortcuts: {
 export declare function shortcutLabel({ modifier, shift, key }: Shortcut): string;
 export declare function ariaKeyShortcuts({ modifier, shift, key }: Shortcut): string;
 export declare function isEditingTarget(target: EventTarget | null): boolean;
+export declare function matchesShortcut(event: KeyboardEvent, shortcut: Shortcut): 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, allowWhileEditing?: boolean): void;

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

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

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

@@ -0,0 +1,2 @@
+/** Stable React ID for SVG definitions and their URL references; safe with identifier prefixes. */
+export declare function useSvgId(): string;

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

@@ -1,7 +1,7 @@
 import type { DatePresetId, DateRange } from '../../core/date-range.js';
 import { type AppVariableValues, type DateRangeSelection, type DateRangeVariable, type HistoryMode, type VariableCollection } from '../../core/variables.js';
-export { defineAppVariables, textVariable, selectVariable, dateRangeVariable, } from '../../core/variables.js';
-export type { AppVariable, AppVariableValues, DateRangeSelection, DateRangeVariable, DateRangeVariableOptions, VariableCollection, } from '../../core/variables.js';
+export { defineAppVariables, searchVariable, choiceVariable, multiChoiceVariable, dateRangeVariable, } from '../../core/variables.js';
+export type { AppVariable, AppVariableValues, ChoiceOption, ChoiceVariable, MultiChoiceVariable, SearchVariable, DateRangeSelection, DateRangeVariable, DateRangeVariableOptions, VariableCollection, } from '../../core/variables.js';
 /** Adapt one date variable to the controlled picker without giving the picker URL ownership. */
 export declare function dateRangeControl(variable: DateRangeVariable, selection: DateRangeSelection, onChange: (selection: DateRangeSelection) => void): {
     minDate?: string;
@@ -27,6 +27,8 @@ export declare function useAppVariables<const Variables extends VariableCollecti
     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;
+    resetAll: () => void;
+    clearAll: () => void;
     update: (next: Partial<AppVariableValues<Variables>>, history?: HistoryMode) => void;
     bind: <Key extends keyof Variables & string>(name: Key) => {
         value: AppVariableValues<Variables>[Key];

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

@@ -6,7 +6,9 @@ export declare function useViewVariables<Variables extends VariableCollection>(d
     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/navigation.js").HistoryMode) => void;
+    resetAll: () => void;
+    clearAll: () => void;
+    update: (next: Partial<AppVariableValues<Variables>>, history?: import("../core/variables.js").HistoryMode) => void;
     bind: <Key extends keyof Variables & string>(name: Key) => {
         value: AppVariableValues<Variables>[Key];
         onChange(value: AppVariableValues<Variables>[Key]): void;

package/dist/types/server/handler.d.ts

@@ -1,13 +1,13 @@
-import { type DataOperations, type Lakehouse } from '../core/contract.js';
+import { type DataOperations, type Lakehouse, type QueryParameters } from '../core/contract.js';
 /** Authorization result for one viewer request. A hosted adapter must scope its lakehouse client. */
 export type RequestAccess = {
     lakehouse: Lakehouse;
-    canDiscloseSql: boolean;
+    /** Trusted values shared across queries; each query uses only its declared keys. */
+    queryParams?: QueryParameters;
 };
 /**
  * Execute named operations on the server. The app supplies operations and viewer authorization.
  * JSON, Origin, and Fetch Metadata checks reject cross-site browser POSTs; they do not
- * authenticate another local process. SQL is returned only when both the operation and
- * authorization result permit disclosure.
+ * authenticate another local process. Query evidence accompanies every result.
  */
 export declare function createDataHandler(operations: DataOperations, authorize: (request: Request, operation: string) => Promise<RequestAccess>): (request: Request) => Promise<Response>;