@dlh.io/bideux 0.1.0

package/dist/types-CHFSsU_X.d.ts

@@ -0,0 +1,1007 @@
+type Kind = "widget";
+type Author = string | null;
+type Description = string;
+type Backgroundcolor = string | null;
+type Border = string | boolean | null;
+type Borderradius = string | number | null;
+type Color = string | null;
+type Fontsize = string | number | null;
+type Fontweight = string | number | null;
+type Padding = string | number | null;
+type Textalign = ("left" | "center" | "right" | "justify") | null;
+type Title = string | LabelBlock | null;
+type Icon = string | null;
+type Position = ("top" | "bottom" | "left" | "right") | null;
+type Text = string | null;
+type Tooltip = string | null;
+type Verticalalign = ("top" | "middle" | "bottom") | null;
+type Visible = boolean | null;
+type Id = string;
+type Name = string;
+type AllowEmbed = boolean;
+type Owner = string | null;
+type Public = boolean;
+type Roles = string[];
+type Scope = "org" | "project" | "dashboard" | "widget";
+type Status = "draft" | "published" | "archived";
+type Tags = string[];
+type Version = string;
+type Tags1 = string[];
+type Version1 = string;
+type Field = string;
+type Operator = "eq" | "in" | "gt" | "lt" | "gte" | "lte" | "contains" | "date" | "between";
+type Param = string | null;
+type Target = string;
+type Bindings = FilterBinding[];
+type Component = "echarts" | "kpi" | "filter" | "select" | "table" | "tabulator" | "pivot_table" | "text" | "image" | "markdown";
+type Data = Data1 | null;
+type Data1 = KpiDataSource | StaticDataSource | DemoDataSource | SqlDataSource | DatasetDataSource | QueryDataSource;
+type DataModelId = string | null;
+type Kind1 = "kpi";
+type Kpi = string;
+type Labelcolumn = string | null;
+type JsonValue = unknown;
+type Valuecolumn = string | null;
+type Columns = string[] | null;
+type Kind2 = "static";
+type Label = string;
+type Options = StaticOption[];
+type Rows = {
+    [k: string]: JsonValue;
+}[];
+type Columns1 = string[] | null;
+type Dataset = string | null;
+type Kind3 = "demo";
+type Rows1 = number;
+type Seed = number;
+type DataModelId1 = string | null;
+type FilterField = string | null;
+type Kind4 = "sql";
+type Query = string;
+type Columns2 = string[] | null;
+type DataModelId2 = string | null;
+type Dataset1 = string;
+type Dimensions = string[] | null;
+type Field1 = string;
+type FilterId = string;
+type Operator1 = "eq" | "in" | "gt" | "lt" | "gte" | "lte" | "contains" | "date" | "between";
+type Param1 = string | null;
+type Filters = IncomingFilter[];
+type Kind5 = "dataset";
+type Metrics = string[] | null;
+type DataModelId3 = string | null;
+type Kind6 = "query";
+type Query1 = string;
+type Background = string | null;
+type Border1 = string | boolean | null;
+type Borderradius1 = string | number | null;
+type Echarts = {
+    [k: string]: JsonValue;
+} | null;
+type Filter = {
+    [k: string]: JsonValue;
+} | null;
+type Image = {
+    [k: string]: JsonValue;
+} | null;
+type Kpi1 = {
+    [k: string]: JsonValue;
+} | null;
+type Margin = string | number | null;
+type Markdown = {
+    [k: string]: JsonValue;
+} | null;
+type Padding1 = string | number | null;
+type PivotTable = {
+    [k: string]: JsonValue;
+} | null;
+type Select = {
+    [k: string]: JsonValue;
+} | null;
+type Shadow = string | boolean | null;
+type Table = {
+    [k: string]: JsonValue;
+} | null;
+type Tabulator = {
+    [k: string]: JsonValue;
+} | null;
+type Text1 = {
+    [k: string]: JsonValue;
+} | null;
+type Filters1 = IncomingFilter[];
+type Id1 = string;
+type Label1 = string | null;
+type OpenIn = "modal" | "same" | "new" | "detail";
+type PassFilters = boolean;
+type PassSelection = boolean;
+type Target1 = string;
+type TargetType = "dashboard" | "url" | "filter" | "dimension";
+type Type = "drilldown" | "set_filter" | "navigate";
+type Field2 = string | null;
+type Kind7 = "event" | "filter" | "literal";
+type Target2 = string;
+type TargetType1 = "filter" | "dimension";
+type VariableMappings = InteractionVariableMapping[];
+type Interactions = WidgetInteraction[];
+type H = number;
+type Isbounded = boolean | null;
+type Isdraggable = boolean | null;
+type Isresizable = boolean | null;
+type Maxh = number | null;
+type Maxw = number | null;
+type Minh = number | null;
+type Minw = number | null;
+type Resizehandles = string[] | null;
+type H1 = number;
+type Isbounded1 = boolean | null;
+type Isdraggable1 = boolean | null;
+type Isresizable1 = boolean | null;
+type Maxh1 = number | null;
+type Maxw1 = number | null;
+type Minh1 = number | null;
+type Minw1 = number | null;
+type Resizehandles1 = string[] | null;
+type W = number;
+type X = number;
+type Y = number;
+type Unplaced = boolean | null;
+type W1 = number;
+type X1 = number;
+type Y1 = number;
+type Category = string | null;
+type Date = string | null;
+type Delta = string | null;
+type Label2 = string | null;
+type Series = string | null;
+type SeriesName = string | null;
+type Value = string | null;
+type X2 = string | null;
+type Y2 = string | null;
+type Version2 = string;
+/**
+ * Specification for a single widget/object.
+ */
+interface WidgetSpec {
+    kind?: Kind;
+    metadata: Metadata;
+    spec: WidgetSpecInner;
+    version?: Version2;
+    [k: string]: unknown;
+}
+/**
+ * Common metadata for dashboards and widgets.
+ */
+interface Metadata {
+    author?: Author;
+    description?: Description;
+    header?: WidgetHeader | null;
+    id: Id;
+    name: Name;
+    platform?: PlatformAttributes;
+    tags?: Tags1;
+    version?: Version1;
+    [k: string]: unknown;
+}
+/**
+ * Object-level header/title configuration for any widget.
+ */
+interface WidgetHeader {
+    backgroundColor?: Backgroundcolor;
+    border?: Border;
+    borderRadius?: Borderradius;
+    color?: Color;
+    fontSize?: Fontsize;
+    fontWeight?: Fontweight;
+    padding?: Padding;
+    textAlign?: Textalign;
+    title?: Title;
+    verticalAlign?: Verticalalign;
+    visible?: Visible;
+    [k: string]: unknown;
+}
+/**
+ * A rich label with optional tooltip and icon.
+ */
+interface LabelBlock {
+    icon?: Icon;
+    position?: Position;
+    text?: Text;
+    tooltip?: Tooltip;
+    [k: string]: unknown;
+}
+/**
+ * Cross-cutting platform attributes attached to every dashboard object.
+ *
+ * These attributes control the relationship of the object to the platform,
+ * the dashboard, the user, and security. They are intentionally generic so
+ * the spec can grow into the larger enterprise BI project.
+ */
+interface PlatformAttributes {
+    allow_embed?: AllowEmbed;
+    owner?: Owner;
+    public?: Public;
+    roles?: Roles;
+    scope?: Scope;
+    status?: Status;
+    tags?: Tags;
+    version?: Version;
+    [k: string]: unknown;
+}
+/**
+ * Inner spec body of a widget.
+ */
+interface WidgetSpecInner {
+    bindings?: Bindings;
+    component?: Component;
+    data?: Data;
+    display?: WidgetDisplay;
+    filters?: Filters1;
+    interactions?: Interactions;
+    layout?: WidgetLayout;
+    mappings?: FieldMapping;
+    [k: string]: unknown;
+}
+/**
+ * How a filter widget is wired to a target widget.
+ */
+interface FilterBinding {
+    field: Field;
+    operator?: Operator;
+    param?: Param;
+    target?: Target;
+    [k: string]: unknown;
+}
+/**
+ * Run a KPI from the catalog.
+ */
+interface KpiDataSource {
+    data_model_id?: DataModelId;
+    kind?: Kind1;
+    kpi: Kpi;
+    labelColumn?: Labelcolumn;
+    params?: Params;
+    valueColumn?: Valuecolumn;
+    [k: string]: unknown;
+}
+interface Params {
+    [k: string]: JsonValue;
+}
+/**
+ * Static data supplied inline in the spec.
+ */
+interface StaticDataSource {
+    columns?: Columns;
+    default_value?: {
+        [k: string]: unknown;
+    };
+    kind?: Kind2;
+    options?: Options;
+    rows?: Rows;
+    [k: string]: unknown;
+}
+/**
+ * A single option for a static select or filter.
+ */
+interface StaticOption {
+    label: Label;
+    value: JsonValue;
+    [k: string]: unknown;
+}
+/**
+ * Deterministic generated data for testing and previews.
+ */
+interface DemoDataSource {
+    columns?: Columns1;
+    dataset?: Dataset;
+    kind?: Kind3;
+    rows?: Rows1;
+    seed?: Seed;
+    [k: string]: unknown;
+}
+/**
+ * Run an arbitrary SQL query against the configured data store.
+ */
+interface SqlDataSource {
+    data_model_id?: DataModelId1;
+    filter_field?: FilterField;
+    kind?: Kind4;
+    params?: Params1;
+    query: Query;
+    [k: string]: unknown;
+}
+interface Params1 {
+    [k: string]: JsonValue;
+}
+/**
+ * Reference a reusable Dataset defined in the dashboard manifest.
+ */
+interface DatasetDataSource {
+    columns?: Columns2;
+    data_model_id?: DataModelId2;
+    dataset: Dataset1;
+    dimensions?: Dimensions;
+    filters?: Filters;
+    kind?: Kind5;
+    metrics?: Metrics;
+    params?: Params2;
+    [k: string]: unknown;
+}
+/**
+ * How a target widget or dataset applies a filter broadcast from the dashboard.
+ */
+interface IncomingFilter {
+    field: Field1;
+    filter_id: FilterId;
+    operator?: Operator1;
+    param?: Param1;
+    [k: string]: unknown;
+}
+interface Params2 {
+    [k: string]: JsonValue;
+}
+/**
+ * Reference a named query defined in the dashboard manifest.
+ */
+interface QueryDataSource {
+    data_model_id?: DataModelId3;
+    kind?: Kind6;
+    params?: Params3;
+    query: Query1;
+    [k: string]: unknown;
+}
+interface Params3 {
+    [k: string]: JsonValue;
+}
+/**
+ * Display-specific configuration.
+ */
+interface WidgetDisplay {
+    background?: Background;
+    border?: Border1;
+    borderRadius?: Borderradius1;
+    echarts?: Echarts;
+    filter?: Filter;
+    image?: Image;
+    kpi?: Kpi1;
+    margin?: Margin;
+    markdown?: Markdown;
+    padding?: Padding1;
+    pivot_table?: PivotTable;
+    select?: Select;
+    shadow?: Shadow;
+    table?: Table;
+    tabulator?: Tabulator;
+    text?: Text1;
+    [k: string]: unknown;
+}
+/**
+ * A user-driven interaction on a widget.
+ */
+interface WidgetInteraction {
+    id: Id1;
+    label?: Label1;
+    open_in?: OpenIn;
+    pass_filters?: PassFilters;
+    pass_selection?: PassSelection;
+    target: Target1;
+    target_type?: TargetType;
+    type: Type;
+    variable_mappings?: VariableMappings;
+    [k: string]: unknown;
+}
+/**
+ * Map a source value (event, filter, or literal) to a target filter/variable.
+ */
+interface InteractionVariableMapping {
+    source?: InteractionVariableSource;
+    target: Target2;
+    target_type?: TargetType1;
+    [k: string]: unknown;
+}
+/**
+ * Source of a value for an interaction variable mapping.
+ */
+interface InteractionVariableSource {
+    field?: Field2;
+    kind?: Kind7;
+    value?: unknown;
+    [k: string]: unknown;
+}
+/**
+ * Layout configuration for a widget.
+ */
+interface WidgetLayout {
+    h?: H;
+    isBounded?: Isbounded;
+    isDraggable?: Isdraggable;
+    isResizable?: Isresizable;
+    maxH?: Maxh;
+    maxW?: Maxw;
+    minH?: Minh;
+    minW?: Minw;
+    resizeHandles?: Resizehandles;
+    responsive?: ResponsiveLayout;
+    unplaced?: Unplaced;
+    w?: W1;
+    x?: X1;
+    y?: Y1;
+    [k: string]: unknown;
+}
+/**
+ * Responsive overrides for a layout item.
+ */
+interface ResponsiveLayout {
+    desktop?: LayoutItem | null;
+    mobile?: LayoutItem | null;
+    tablet?: LayoutItem | null;
+    wide?: LayoutItem | null;
+    [k: string]: unknown;
+}
+/**
+ * A single position/size entry in a responsive grid.
+ */
+interface LayoutItem {
+    h?: H1;
+    isBounded?: Isbounded1;
+    isDraggable?: Isdraggable1;
+    isResizable?: Isresizable1;
+    maxH?: Maxh1;
+    maxW?: Maxw1;
+    minH?: Minh1;
+    minW?: Minw1;
+    resizeHandles?: Resizehandles1;
+    w?: W;
+    x?: X;
+    y?: Y;
+    [k: string]: unknown;
+}
+/**
+ * Map widget fields to columns in the data source.
+ */
+interface FieldMapping {
+    category?: Category;
+    date?: Date;
+    delta?: Delta;
+    label?: Label2;
+    series?: Series;
+    series_name?: SeriesName;
+    value?: Value;
+    x?: X2;
+    y?: Y2;
+    [k: string]: unknown;
+}
+
+interface WidgetInteractionContext {
+    widgetId: string;
+    data?: Record<string, unknown>;
+    value?: unknown;
+}
+interface DrillStackItem {
+    id: string;
+    name: string;
+    filters: Record<string, unknown>;
+}
+declare function getClickInteraction(widget: WidgetSpec): WidgetInteraction | undefined;
+declare function findEventRow(rows: Record<string, unknown>[], mappings: WidgetSpec["spec"]["mappings"], name?: string | null, seriesName?: string | null): Record<string, unknown> | undefined;
+declare function resolveInteractionValue(mapping: NonNullable<WidgetInteraction["variable_mappings"]>[number], context: WidgetInteractionContext, currentFilters: Record<string, unknown>): unknown;
+declare function resolveInteractionValues(interaction: WidgetInteraction, context: WidgetInteractionContext, currentFilters: Record<string, unknown>): Record<string, unknown>;
+declare function isUrlInteraction(interaction: WidgetInteraction): boolean;
+declare function encodeDrillStack(stack: DrillStackItem[]): string;
+declare function decodeDrillStack(raw: string | null): DrillStackItem[];
+declare function buildDrillUrl(targetDashboardId: string, targetFilters: Record<string, unknown>, currentStack: DrillStackItem[], options?: {
+    detail?: boolean;
+    currentDashboard?: DrillStackItem;
+}): string;
+
+type ChartOption = Record<string, unknown>;
+type DataRow = Record<string, unknown>;
+type WidgetResult = Record<string, unknown>;
+type WidgetComponent = "echarts" | "kpi" | "filter" | "select" | "table" | "tabulator" | "pivot_table" | "text" | "image" | "markdown";
+interface RendererLabel {
+    text?: string;
+    position: "top" | "bottom";
+    tooltip?: string;
+    tooltipIcon?: "info" | "check" | "help" | "warning";
+}
+interface WidgetTheme {
+    padding?: string | number;
+    margin?: string | number;
+    borderRadius?: string | number;
+    background?: string;
+    border?: string | boolean;
+    shadow?: string | boolean;
+}
+type WidgetDefaults = Partial<Record<WidgetComponent | "global", WidgetTheme>>;
+interface RendererFrame {
+    widgetId: string;
+    component: string;
+    theme: WidgetTheme;
+    showObjectHeader: boolean;
+    label?: RendererLabel;
+    interactive: boolean;
+}
+interface KpiDeltaModel {
+    value: number;
+    formattedValue: string;
+    tone: "up" | "down" | "flat";
+    icon: "up" | "down" | "neutral" | "none";
+    comparedWith?: string;
+    tooltip?: string;
+    tooltipIcon?: "info" | "check" | "help" | "warning";
+    color?: string;
+    reference?: {
+        value: number;
+        formattedValue: string;
+    };
+}
+interface KpiValueFormat {
+    format: string;
+    prefix: string;
+    suffix: string;
+    compact: boolean;
+    decimals?: number;
+}
+interface KpiRendererModel {
+    kind: "kpi";
+    frame: RendererFrame;
+    value: number;
+    formattedValue: string;
+    settledValue: string;
+    /** How the value was formatted, so a host can format intermediate values the same way. */
+    valueFormat: KpiValueFormat;
+    delta?: KpiDeltaModel;
+    note?: string;
+}
+interface ChartRendererModel {
+    kind: "chart";
+    frame: RendererFrame;
+    option: ChartOption;
+    axisKey: string;
+    structureKey: string;
+    loading: boolean;
+}
+interface TextRendererStyle {
+    textAlign: "left" | "center" | "right" | "justify";
+    verticalAlign: "top" | "middle" | "bottom";
+    fontSize?: string | number;
+    fontWeight?: string | number;
+    color?: string;
+    lineHeight?: string | number;
+    letterSpacing?: string | number;
+    whiteSpace?: "normal" | "nowrap" | "pre" | "pre-wrap" | "pre-line";
+    truncate: boolean;
+    custom: Record<string, string | number>;
+}
+interface TextRendererModel {
+    kind: "text";
+    frame: RendererFrame;
+    content: string;
+    contentFormat: "text" | "markdown";
+    style: TextRendererStyle;
+}
+interface MarkdownRendererModel {
+    kind: "markdown";
+    frame: RendererFrame;
+    content: string;
+}
+interface ImageRendererModel {
+    kind: "image";
+    frame: RendererFrame;
+    source: string | null;
+    alt: string;
+    objectFit: "cover" | "contain";
+}
+type SortDirection = "asc" | "desc";
+interface TableSortState {
+    column: string;
+    direction: SortDirection;
+}
+interface TableExportModel {
+    csv: boolean;
+    excel: boolean;
+    filename: string;
+}
+interface TableColumnModel {
+    field: string;
+    title: string;
+    sortable: boolean;
+    sortDirection: SortDirection | null;
+}
+interface TableCellModel {
+    field: string;
+    value: unknown;
+    text: string;
+}
+interface TableRowModel {
+    key: number;
+    data: DataRow;
+    cells: TableCellModel[];
+}
+interface TableRendererModel {
+    kind: "table";
+    frame: RendererFrame;
+    columns: TableColumnModel[];
+    rows: TableRowModel[];
+    allRows: DataRow[];
+    page: number;
+    pageSize: number;
+    pageCount: number;
+    totalRows: number;
+    sort: TableSortState | null;
+    exports: TableExportModel;
+}
+type GridColumnFormatterModel = {
+    kind: "percent";
+    precision: number;
+    params: Record<string, unknown>;
+} | {
+    kind: "named";
+    name: string;
+    params: Record<string, unknown>;
+};
+interface GridColumnModel {
+    field: string;
+    title: string;
+    frozen: boolean;
+    headerSort: boolean;
+    formatter?: GridColumnFormatterModel;
+    width?: number | string;
+    headerTooltip?: string;
+    sorter?: string;
+}
+interface GridOptionsModel {
+    layout: "fitColumns" | "fitData" | "fitDataFill";
+    pagination: boolean;
+    pageSize?: number;
+    groupBy?: string;
+    groupStartOpen: boolean;
+    sortable: boolean;
+}
+interface TabulatorRendererModel {
+    kind: "tabulator";
+    frame: RendererFrame;
+    columns: GridColumnModel[];
+    rows: DataRow[];
+    options: GridOptionsModel;
+    exports: TableExportModel;
+}
+type PivotAggregation = "sum" | "avg" | "min" | "max" | "count" | "count_distinct";
+interface PivotFieldPayload {
+    key: string;
+    label: string;
+}
+interface PivotMeasurePayload {
+    key: string;
+    label: string;
+    agg: PivotAggregation;
+    format: "number" | "currency" | "percent" | null;
+    decimals: number | null;
+}
+interface PivotColumnNode {
+    key: string;
+    label: string;
+    column: string | null;
+    measure: string | null;
+    is_total: boolean;
+    is_group_total: boolean;
+    children: PivotColumnNode[];
+}
+type PivotRowKind = "group" | "leaf" | "other" | "grand_total";
+type PivotDirection = "asc" | "desc";
+interface PivotRowPayload {
+    key: string;
+    label: string;
+    path: string[];
+    depth: number;
+    kind: PivotRowKind;
+    cells: Record<string, number | null>;
+}
+interface PivotTablePayload {
+    row_fields: PivotFieldPayload[];
+    column_fields: PivotFieldPayload[];
+    measures: PivotMeasurePayload[];
+    column_tree: PivotColumnNode[];
+    column_keys: string[];
+    column_labels: Record<string, string>;
+    rows: PivotRowPayload[];
+    total_row: PivotRowPayload | null;
+    value_range: Record<string, {
+        min: number;
+        max: number;
+    }>;
+    empty_value: string;
+    subtotals: "expanded" | "collapsed" | "none";
+    heatmap_measure: string | null;
+    snapshot_expand: number | null;
+    snapshot_expand_columns?: number | null;
+    sort: {
+        column: string | null;
+        measure: string | null;
+        direction: PivotDirection;
+    };
+    truncated: {
+        row_groups: number;
+        row_groups_total: number;
+        rolled_up: number;
+        columns: number;
+        columns_total: number;
+    };
+    fields: {
+        dimensions: PivotFieldPayload[];
+        measures: PivotFieldPayload[];
+    };
+    explore: boolean;
+    explored: boolean;
+    source?: {
+        records: (string | number | null)[][];
+    };
+}
+interface PivotDetailColumn {
+    key: string;
+    label: string;
+}
+interface PivotDetailResult {
+    component: "pivot_detail";
+    columns: PivotDetailColumn[];
+    rows: DataRow[];
+    row_count: number;
+    truncated: boolean;
+}
+declare const PIVOT_META_PROP = "__pivotMeta";
+interface PivotGridRowMeta {
+    key: string;
+    label: string;
+    path: string[];
+    depth: number;
+    kind: PivotRowKind;
+}
+interface PivotGridRow {
+    [PIVOT_META_PROP]: PivotGridRowMeta;
+    [prop: string]: string | number | null | PivotGridRowMeta;
+}
+interface PivotGridColumn {
+    prop: string;
+    name: string;
+    columnKey: string | null;
+    measure: string | null;
+    isTotal: boolean;
+    isRowField: boolean;
+    pinStart: boolean;
+}
+interface PivotGridColumnGroup {
+    name: string;
+    key: string;
+    foldable: boolean;
+    folded: boolean;
+    leafCount: number;
+    children: PivotGridColumnDefinition[];
+}
+type PivotGridColumnDefinition = PivotGridColumn | PivotGridColumnGroup;
+interface PivotSortState {
+    column: string;
+    direction: PivotDirection;
+}
+type PivotFilterOp = "gte" | "gt" | "eq" | "lte" | "lt";
+interface PivotColumnFilter {
+    op: PivotFilterOp;
+    value: number;
+}
+interface PivotViewState {
+    collapsed: ReadonlySet<string>;
+    collapsedColumns: ReadonlySet<string>;
+    search: string;
+    filters: Readonly<Record<string, PivotColumnFilter>>;
+    sort: PivotSortState | null;
+}
+interface PivotOpenLevels {
+    rows: number | null;
+    columns: number | null;
+}
+interface PivotCellPresentation {
+    text: string;
+    align: "left" | "right";
+    emphasized: boolean;
+    heatmapIntensity: number | null;
+}
+interface PivotControlsModel {
+    searchPlaceholder: string;
+    expandable: boolean;
+    groupCount: number;
+    filterCount: number;
+    reordered: boolean;
+    canFilter: true;
+    canRearrange: false;
+    embedded: boolean;
+}
+interface MissingPivotRendererModel {
+    kind: "pivot";
+    status: "missing";
+    frame: RendererFrame;
+    message: "This widget did not return a pivot table.";
+}
+interface ReadyPivotRendererModel {
+    kind: "pivot";
+    status: "ready";
+    frame: RendererFrame;
+    payload: PivotTablePayload;
+    view: PivotViewState;
+    columns: PivotGridColumnDefinition[];
+    rows: PivotGridRow[];
+    totalRow: PivotGridRow | null;
+    valueColumns: PivotFieldPayload[];
+    columnGroups: PivotFieldPayload[];
+    truncation: string | null;
+    controls: PivotControlsModel;
+    exports: TableExportModel;
+    openLevels: PivotOpenLevels;
+}
+type PivotRendererModel = MissingPivotRendererModel | ReadyPivotRendererModel;
+type PivotCellAction = {
+    kind: "toggle-row-group";
+    key: string;
+} | {
+    kind: "interaction";
+    interaction: WidgetInteraction;
+    context: WidgetInteractionContext;
+} | {
+    kind: "detail";
+    filters: Record<string, string>;
+    label: string;
+};
+interface UnknownRendererModel {
+    kind: "unknown";
+    frame: RendererFrame;
+    message: "Unknown widget type";
+}
+interface ExtensionRendererModel {
+    kind: "extension";
+    frame: RendererFrame;
+    name: string;
+    content: unknown;
+}
+type BasicRendererModel = KpiRendererModel | ChartRendererModel | TableRendererModel | TabulatorRendererModel | PivotRendererModel | TextRendererModel | MarkdownRendererModel | ImageRendererModel | UnknownRendererModel | ExtensionRendererModel;
+type WidgetRenderState = {
+    kind: "loading";
+    skeleton: "kpi" | "chart" | "content";
+    message: "Loading widget";
+} | {
+    kind: "error";
+    message: string;
+    hint?: string;
+    retryable: boolean;
+} | {
+    kind: "notice";
+    message: string;
+} | {
+    kind: "ready";
+    refreshing: boolean;
+};
+interface WidgetRenderResolution {
+    state: WidgetRenderState;
+    answeredOnce: boolean;
+    model?: BasicRendererModel;
+}
+interface RendererContext {
+    filters?: Record<string, unknown>;
+    filterLabels?: Record<string, string>;
+    widgetDefaults?: WidgetDefaults;
+    reducedMotion?: boolean;
+    answeredOnce?: boolean;
+    loading?: boolean;
+    retryable?: boolean;
+    registry?: RendererRegistry;
+    tableSort?: TableSortState | null;
+    tablePage?: number;
+    pivotView?: PivotViewState;
+    capture?: boolean;
+    embedded?: boolean;
+    /**
+     * True when a host frame already draws the card around the renderer, so the
+     * renderer keeps only its inner padding and draws no border, shadow, radius
+     * or background of its own.
+     */
+    framed?: boolean;
+    /**
+     * False when no host exporter can write Excel files, so renderers hide
+     * their Excel button and keep CSV.
+     */
+    excelExport?: boolean;
+}
+interface RendererExtensionInput {
+    widget: WidgetSpec;
+    result: WidgetResult;
+    frame: RendererFrame;
+    context: RendererContext;
+}
+type RendererExtension = (input: RendererExtensionInput) => unknown;
+interface RendererRegistry {
+    register(name: string, renderer: RendererExtension): void;
+    unregister(name: string): void;
+    get(name: string): RendererExtension | undefined;
+}
+type TabularRendererModel = TabulatorRendererModel | ReadyPivotRendererModel;
+interface TabularGridAdapter<TOutput = unknown> {
+    readonly name: string;
+    project(model: TabularRendererModel): TOutput;
+}
+
+interface BrowserRenderer<TInput> {
+    update(input: TInput): void;
+    resize(): void;
+    destroy(): void;
+}
+interface RendererThemeTokens {
+    foreground: string;
+    mutedForeground: string;
+    border: string;
+    surface: string;
+    surfaceForeground: string;
+    primary: string;
+    secondary: string;
+    danger: string;
+    fontFamily: string;
+    seriesColors: string[];
+    heatmapColors: string[];
+}
+interface RendererLicenseRequest {
+    renderer: "revogrid";
+    capability: "pivot-pro";
+}
+interface RendererLicensePort {
+    getLicense(request: RendererLicenseRequest): string | null | Promise<string | null>;
+}
+interface RendererExtensionMount {
+    element: HTMLElement;
+    model: Extract<BasicRendererModel, {
+        kind: "extension";
+    }>;
+}
+interface RendererExportRequest {
+    widgetId: string;
+    format: "csv" | "excel";
+    filename: string;
+}
+interface RendererPivotDetailRequest {
+    widgetId: string;
+    filters: Record<string, string>;
+    label: string;
+}
+interface RendererHostCallbacks {
+    onInteraction?: (interaction: WidgetInteraction, context: WidgetInteractionContext) => void;
+    onFilterChange?: (widgetId: string, value: unknown) => void;
+    onFilterLabelChange?: (widgetId: string, label: string) => void;
+    onExport?: (request: RendererExportRequest) => void | Promise<void>;
+    onPivotViewChange?: (widgetId: string, view: PivotViewState) => void;
+    onPivotDetail?: (request: RendererPivotDetailRequest) => void | Promise<void>;
+    onRetry?: () => void;
+    onError?: (error: Error) => void;
+    renderExtension?: (input: RendererExtensionMount) => BrowserRenderer<RendererExtensionMount> | void;
+}
+interface NativeWidgetRenderInput {
+    element: HTMLElement;
+    widget: WidgetSpec;
+    result?: WidgetResult;
+    context?: RendererContext;
+    filterValue?: unknown;
+    callbacks?: RendererHostCallbacks;
+    theme?: Partial<RendererThemeTokens>;
+}
+/**
+ * One widget renderer, whatever library draws it. A shell mounts a widget by
+ * asking a factory for this handle, then updates it as results and filters
+ * change, and destroys it on unmount.
+ */
+type WidgetRendererHandle = BrowserRenderer<NativeWidgetRenderInput>;
+type WidgetRendererFactory = (input: NativeWidgetRenderInput) => WidgetRendererHandle | Promise<WidgetRendererHandle>;
+/**
+ * Factories keyed by widget component, with a fallback for every component the
+ * host did not name. A host wires the concrete renderer packages here, so no
+ * shell carries a charting or grid dependency of its own.
+ */
+type WidgetRendererFactories = Partial<Record<string, WidgetRendererFactory>> & {
+    default?: WidgetRendererFactory;
+};
+declare const defaultRendererTheme: RendererThemeTokens;
+declare function resolveRendererTheme(theme?: Partial<RendererThemeTokens>): RendererThemeTokens;
+
+export { type PivotAggregation as $, type PivotRowKind as A, type BasicRendererModel as B, type ChartOption as C, type DataRow as D, type ExtensionRendererModel as E, type FieldMapping as F, type GridColumnFormatterModel as G, type PivotRowPayload as H, type ImageRendererModel as I, type PivotSortState as J, type KpiDeltaModel as K, type LabelBlock as L, type MarkdownRendererModel as M, type NativeWidgetRenderInput as N, type PivotTablePayload as O, PIVOT_META_PROP as P, type PivotViewState as Q, type ReadyPivotRendererModel as R, type RendererContext as S, type RendererExtension as T, type RendererExtensionInput as U, type RendererExtensionMount as V, type RendererFrame as W, type RendererHostCallbacks as X, type RendererLabel as Y, type RendererLicensePort as Z, type RendererLicenseRequest as _, type BrowserRenderer as a, type RendererPivotDetailRequest as a0, type PivotDirection as a1, type PivotOpenLevels as a2, type RendererRegistry as a3, type RendererThemeTokens as a4, type ResponsiveLayout as a5, type SortDirection as a6, type TableCellModel as a7, type TableColumnModel as a8, type TableExportModel as a9, defaultRendererTheme as aA, encodeDrillStack as aB, findEventRow as aC, getClickInteraction as aD, isUrlInteraction as aE, resolveInteractionValue as aF, resolveInteractionValues as aG, resolveRendererTheme as aH, type TableRendererModel as aa, type TableRowModel as ab, type TableSortState as ac, type TabularGridAdapter as ad, type TabularRendererModel as ae, type TabulatorRendererModel as af, type TextRendererModel as ag, type TextRendererStyle as ah, type UnknownRendererModel as ai, type RendererExportRequest as aj, type WidgetComponent as ak, type WidgetDefaults as al, type WidgetHeader as am, type WidgetInteraction as an, type WidgetInteractionContext as ao, type WidgetLayout as ap, type WidgetRenderResolution as aq, type WidgetRenderState as ar, type WidgetRendererFactories as as, type WidgetRendererFactory as at, type WidgetRendererHandle as au, type WidgetResult as av, type WidgetSpec as aw, type WidgetTheme as ax, buildDrillUrl as ay, decodeDrillStack as az, type ChartRendererModel as b, type DrillStackItem as c, type GridColumnModel as d, type GridOptionsModel as e, type InteractionVariableMapping as f, type InteractionVariableSource as g, type KpiRendererModel as h, type KpiValueFormat as i, type MissingPivotRendererModel as j, type PivotCellAction as k, type PivotCellPresentation as l, type PivotColumnFilter as m, type PivotColumnNode as n, type PivotControlsModel as o, type PivotDetailColumn as p, type PivotDetailResult as q, type PivotFieldPayload as r, type PivotFilterOp as s, type PivotGridColumn as t, type PivotGridColumnDefinition as u, type PivotGridColumnGroup as v, type PivotGridRow as w, type PivotGridRowMeta as x, type PivotMeasurePayload as y, type PivotRendererModel as z };