buckaroo-js-core 0.8.5 → 0.14.0

package/dist/src/components/utils.d.ts

@@ -0,0 +1,299 @@
+import { DFWhole } from './DFViewerParts/DFWhole';
+import { ColDef } from 'ag-grid-community';
+export type setDFFunc = (newDf: DFWhole) => void;
+export declare const requestDf: (url: string, setCallBack: setDFFunc) => Promise<void>;
+export declare const sym: (symbolName: string) => {
+    symbol: string;
+};
+export declare function replaceInArr<T>(arr: T[], old: T, subst: T): T[];
+export declare function replaceAtIdx<T>(arr: T[], idx: number, subst: T): T[];
+export declare function replaceAtKey<T>(obj: Record<string, T>, key: string, subst: T): Record<string, T>;
+export declare const objWithoutNull: (obj: Record<string, string>, extraStrips?: string[]) => Record<string, string>;
+export declare const updateAtMatch: (cols: ColDef[], key: string, subst: Partial<ColDef>, negative: Partial<ColDef>) => {
+    colId?: string;
+    field?: string | undefined;
+    type?: string | string[];
+    cellDataType?: boolean | string;
+    valueGetter?: string | import('ag-grid-community').ValueGetterFunc<any, any> | undefined;
+    valueFormatter?: string | import('ag-grid-community').ValueFormatterFunc<any, any> | undefined;
+    refData?: {
+        [key: string]: string;
+    };
+    keyCreator?: ((params: import('ag-grid-community').KeyCreatorParams<any, any>) => string) | undefined;
+    equals?: ((valueA: any, valueB: any) => boolean) | undefined;
+    tooltipField?: string | undefined;
+    tooltipValueGetter?: ((params: import('ag-grid-community').ITooltipParams<any, any, any>) => string | any) | undefined;
+    checkboxSelection?: boolean | import('ag-grid-community').CheckboxSelectionCallback<any, any> | undefined;
+    showDisabledCheckboxes?: boolean;
+    icons?: {
+        [key: string]: ((...args: any[]) => any) | string;
+    };
+    suppressNavigable?: boolean | import('ag-grid-community').SuppressNavigableCallback<any, any> | undefined;
+    suppressKeyboardEvent?: ((params: import('ag-grid-community').SuppressKeyboardEventParams<any, any>) => boolean) | undefined;
+    suppressPaste?: boolean | import('ag-grid-community').SuppressPasteCallback<any, any> | undefined;
+    suppressFillHandle?: boolean;
+    hide?: boolean;
+    initialHide?: boolean;
+    lockVisible?: boolean;
+    lockPosition?: boolean | "left" | "right";
+    suppressMovable?: boolean;
+    useValueFormatterForExport?: boolean;
+    editable?: boolean | import('ag-grid-community').EditableCallback<any, any> | undefined;
+    valueSetter?: string | import('ag-grid-community').ValueSetterFunc<any, any> | undefined;
+    valueParser?: string | import('ag-grid-community').ValueParserFunc<any, any> | undefined;
+    cellEditor?: any;
+    cellEditorParams?: any;
+    cellEditorSelector?: import('ag-grid-community').CellEditorSelectorFunc<any, any> | undefined;
+    singleClickEdit?: boolean;
+    cellEditorPopup?: boolean;
+    cellEditorPopupPosition?: "over" | "under";
+    useValueParserForImport?: boolean;
+    onCellValueChanged?: ((event: import('ag-grid-community').NewValueParams<any, any>) => void) | undefined;
+    onCellClicked?: ((event: import('ag-grid-community').CellClickedEvent<any, any>) => void) | undefined;
+    onCellDoubleClicked?: ((event: import('ag-grid-community').CellDoubleClickedEvent<any, any>) => void) | undefined;
+    onCellContextMenu?: ((event: import('ag-grid-community').CellContextMenuEvent<any, any>) => void) | undefined;
+    getQuickFilterText?: ((params: import('ag-grid-community').GetQuickFilterTextParams<any, any>) => string) | undefined;
+    filterValueGetter?: string | import('ag-grid-community').ValueGetterFunc<any, any> | undefined;
+    floatingFilter?: boolean;
+    suppressFloatingFilterButton?: boolean;
+    dateComponent?: any;
+    dateComponentParams?: any;
+    getFindText?: import('ag-grid-community').GetFindTextFunc<any, any> | undefined;
+    headerComponent?: any;
+    headerComponentParams?: any;
+    menuTabs?: import('ag-grid-community').ColumnMenuTab[];
+    columnChooserParams?: import('ag-grid-community').ColumnChooserParams;
+    suppressHeaderMenuButton?: boolean;
+    suppressHeaderFilterButton?: boolean;
+    mainMenuItems?: (import('ag-grid-community').DefaultMenuItem | import('ag-grid-community').MenuItemDef<any, any>)[] | import('ag-grid-community').GetMainMenuItems<any, any> | undefined;
+    contextMenuItems?: (import('ag-grid-community').DefaultMenuItem | import('ag-grid-community').MenuItemDef<any, any>)[] | import('ag-grid-community').GetContextMenuItems<any, any> | undefined;
+    headerCheckboxSelection?: boolean | import('ag-grid-community').HeaderCheckboxSelectionCallback<any, any> | undefined;
+    headerCheckboxSelectionFilteredOnly?: boolean;
+    headerCheckboxSelectionCurrentPageOnly?: boolean;
+    chartDataType?: "category" | "series" | "time" | "excluded";
+    pinned?: boolean | "left" | "right" | null;
+    initialPinned?: boolean | "left" | "right";
+    lockPinned?: boolean;
+    pivot?: boolean;
+    initialPivot?: boolean;
+    pivotIndex?: number | null;
+    initialPivotIndex?: number;
+    pivotComparator?: (valueA: string, valueB: string) => number;
+    enablePivot?: boolean;
+    cellStyle?: import('ag-grid-community').CellStyle | import('ag-grid-community').CellStyleFunc<any, any> | undefined;
+    cellClass?: string | string[] | import('ag-grid-community').CellClassFunc<any, any> | undefined;
+    cellClassRules?: import('ag-grid-community').CellClassRules<any, any> | undefined;
+    cellRenderer?: any;
+    cellRendererParams?: any;
+    cellRendererSelector?: import('ag-grid-community').CellRendererSelectorFunc<any, any> | undefined;
+    loadingCellRenderer?: any;
+    loadingCellRendererParams?: any;
+    loadingCellRendererSelector?: import('ag-grid-community').CellRendererSelectorFunc<any, any> | undefined;
+    autoHeight?: boolean;
+    wrapText?: boolean;
+    enableCellChangeFlash?: boolean;
+    rowDrag?: boolean | import('ag-grid-community').RowDragCallback<any, any> | undefined;
+    rowDragText?: (params: import('ag-grid-community').IRowDragItem, dragItemCount: number) => string;
+    dndSource?: boolean | import('ag-grid-community').DndSourceCallback<any, any> | undefined;
+    dndSourceOnRowDrag?: ((params: import('ag-grid-community').DndSourceOnRowDragParams<any>) => void) | undefined;
+    rowGroup?: boolean;
+    initialRowGroup?: boolean;
+    rowGroupIndex?: number | null;
+    initialRowGroupIndex?: number;
+    enableRowGroup?: boolean;
+    enableValue?: boolean;
+    aggFunc?: string | import('ag-grid-community').IAggFunc<any, any> | null | undefined;
+    initialAggFunc?: string | import('ag-grid-community').IAggFunc<any, any> | undefined;
+    defaultAggFunc?: string;
+    allowedAggFuncs?: string[];
+    showRowGroup?: string | boolean;
+    sortable?: boolean;
+    sort?: import('ag-grid-community').SortDirection;
+    initialSort?: import('ag-grid-community').SortDirection;
+    sortIndex?: number | null;
+    initialSortIndex?: number;
+    sortingOrder?: import('ag-grid-community').SortDirection[];
+    comparator?: ((valueA: any, valueB: any, nodeA: import('ag-grid-community').IRowNode<any>, nodeB: import('ag-grid-community').IRowNode<any>, isDescending: boolean) => number) | undefined;
+    unSortIcon?: boolean;
+    colSpan?: ((params: import('ag-grid-community').ColSpanParams<any, any>) => number) | undefined;
+    rowSpan?: ((params: import('ag-grid-community').RowSpanParams<any, any>) => number) | undefined;
+    spanRows?: boolean | ((params: import('ag-grid-community').SpanRowsParams<any, any>) => boolean) | undefined;
+    width?: number;
+    initialWidth?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    flex?: number;
+    initialFlex?: number;
+    resizable?: boolean;
+    suppressSizeToFit?: boolean;
+    suppressAutoSize?: boolean;
+    pivotValueColumn?: import('ag-grid-community').Column | null;
+    pivotTotalColumnIds?: string[];
+    suppressSpanHeaderHeight?: boolean;
+    headerName?: string;
+    headerValueGetter?: string | import('ag-grid-community').HeaderValueGetterFunc<any, any> | undefined;
+    headerTooltip?: string;
+    headerStyle?: import('ag-grid-community').HeaderStyle | import('ag-grid-community').HeaderStyleFunc<any, any> | undefined;
+    headerClass?: import('ag-grid-community').HeaderClass<any, any> | undefined;
+    suppressHeaderKeyboardEvent?: ((params: import('ag-grid-community').SuppressHeaderKeyboardEventParams<any, any>) => boolean) | undefined;
+    columnGroupShow?: import('ag-grid-community').ColumnGroupShowType;
+    toolPanelClass?: import('ag-grid-community').ToolPanelClass<any, any> | undefined;
+    suppressColumnsToolPanel?: boolean;
+    suppressFiltersToolPanel?: boolean;
+    tooltipComponent?: any;
+    tooltipComponentParams?: any;
+    pivotKeys?: string[];
+    cellAriaRole?: string;
+    context?: any;
+    wrapHeaderText?: boolean;
+    autoHeaderHeight?: boolean;
+    suppressHeaderContextMenu?: boolean;
+    filter?: any;
+    filterParams?: any;
+    floatingFilterComponent?: any;
+    floatingFilterComponentParams?: any;
+}[];
+export declare const replaceAtMatch: (cols: ColDef[], key: string, subst: Partial<ColDef>) => {
+    colId?: string;
+    field?: string | undefined;
+    type?: string | string[];
+    cellDataType?: boolean | string;
+    valueGetter?: string | import('ag-grid-community').ValueGetterFunc<any, any> | undefined;
+    valueFormatter?: string | import('ag-grid-community').ValueFormatterFunc<any, any> | undefined;
+    refData?: {
+        [key: string]: string;
+    };
+    keyCreator?: ((params: import('ag-grid-community').KeyCreatorParams<any, any>) => string) | undefined;
+    equals?: ((valueA: any, valueB: any) => boolean) | undefined;
+    tooltipField?: string | undefined;
+    tooltipValueGetter?: ((params: import('ag-grid-community').ITooltipParams<any, any, any>) => string | any) | undefined;
+    checkboxSelection?: boolean | import('ag-grid-community').CheckboxSelectionCallback<any, any> | undefined;
+    showDisabledCheckboxes?: boolean;
+    icons?: {
+        [key: string]: ((...args: any[]) => any) | string;
+    };
+    suppressNavigable?: boolean | import('ag-grid-community').SuppressNavigableCallback<any, any> | undefined;
+    suppressKeyboardEvent?: ((params: import('ag-grid-community').SuppressKeyboardEventParams<any, any>) => boolean) | undefined;
+    suppressPaste?: boolean | import('ag-grid-community').SuppressPasteCallback<any, any> | undefined;
+    suppressFillHandle?: boolean;
+    hide?: boolean;
+    initialHide?: boolean;
+    lockVisible?: boolean;
+    lockPosition?: boolean | "left" | "right";
+    suppressMovable?: boolean;
+    useValueFormatterForExport?: boolean;
+    editable?: boolean | import('ag-grid-community').EditableCallback<any, any> | undefined;
+    valueSetter?: string | import('ag-grid-community').ValueSetterFunc<any, any> | undefined;
+    valueParser?: string | import('ag-grid-community').ValueParserFunc<any, any> | undefined;
+    cellEditor?: any;
+    cellEditorParams?: any;
+    cellEditorSelector?: import('ag-grid-community').CellEditorSelectorFunc<any, any> | undefined;
+    singleClickEdit?: boolean;
+    cellEditorPopup?: boolean;
+    cellEditorPopupPosition?: "over" | "under";
+    useValueParserForImport?: boolean;
+    onCellValueChanged?: ((event: import('ag-grid-community').NewValueParams<any, any>) => void) | undefined;
+    onCellClicked?: ((event: import('ag-grid-community').CellClickedEvent<any, any>) => void) | undefined;
+    onCellDoubleClicked?: ((event: import('ag-grid-community').CellDoubleClickedEvent<any, any>) => void) | undefined;
+    onCellContextMenu?: ((event: import('ag-grid-community').CellContextMenuEvent<any, any>) => void) | undefined;
+    getQuickFilterText?: ((params: import('ag-grid-community').GetQuickFilterTextParams<any, any>) => string) | undefined;
+    filterValueGetter?: string | import('ag-grid-community').ValueGetterFunc<any, any> | undefined;
+    floatingFilter?: boolean;
+    suppressFloatingFilterButton?: boolean;
+    dateComponent?: any;
+    dateComponentParams?: any;
+    getFindText?: import('ag-grid-community').GetFindTextFunc<any, any> | undefined;
+    headerComponent?: any;
+    headerComponentParams?: any;
+    menuTabs?: import('ag-grid-community').ColumnMenuTab[];
+    columnChooserParams?: import('ag-grid-community').ColumnChooserParams;
+    suppressHeaderMenuButton?: boolean;
+    suppressHeaderFilterButton?: boolean;
+    mainMenuItems?: (import('ag-grid-community').DefaultMenuItem | import('ag-grid-community').MenuItemDef<any, any>)[] | import('ag-grid-community').GetMainMenuItems<any, any> | undefined;
+    contextMenuItems?: (import('ag-grid-community').DefaultMenuItem | import('ag-grid-community').MenuItemDef<any, any>)[] | import('ag-grid-community').GetContextMenuItems<any, any> | undefined;
+    headerCheckboxSelection?: boolean | import('ag-grid-community').HeaderCheckboxSelectionCallback<any, any> | undefined;
+    headerCheckboxSelectionFilteredOnly?: boolean;
+    headerCheckboxSelectionCurrentPageOnly?: boolean;
+    chartDataType?: "category" | "series" | "time" | "excluded";
+    pinned?: boolean | "left" | "right" | null;
+    initialPinned?: boolean | "left" | "right";
+    lockPinned?: boolean;
+    pivot?: boolean;
+    initialPivot?: boolean;
+    pivotIndex?: number | null;
+    initialPivotIndex?: number;
+    pivotComparator?: (valueA: string, valueB: string) => number;
+    enablePivot?: boolean;
+    cellStyle?: import('ag-grid-community').CellStyle | import('ag-grid-community').CellStyleFunc<any, any> | undefined;
+    cellClass?: string | string[] | import('ag-grid-community').CellClassFunc<any, any> | undefined;
+    cellClassRules?: import('ag-grid-community').CellClassRules<any, any> | undefined;
+    cellRenderer?: any;
+    cellRendererParams?: any;
+    cellRendererSelector?: import('ag-grid-community').CellRendererSelectorFunc<any, any> | undefined;
+    loadingCellRenderer?: any;
+    loadingCellRendererParams?: any;
+    loadingCellRendererSelector?: import('ag-grid-community').CellRendererSelectorFunc<any, any> | undefined;
+    autoHeight?: boolean;
+    wrapText?: boolean;
+    enableCellChangeFlash?: boolean;
+    rowDrag?: boolean | import('ag-grid-community').RowDragCallback<any, any> | undefined;
+    rowDragText?: (params: import('ag-grid-community').IRowDragItem, dragItemCount: number) => string;
+    dndSource?: boolean | import('ag-grid-community').DndSourceCallback<any, any> | undefined;
+    dndSourceOnRowDrag?: ((params: import('ag-grid-community').DndSourceOnRowDragParams<any>) => void) | undefined;
+    rowGroup?: boolean;
+    initialRowGroup?: boolean;
+    rowGroupIndex?: number | null;
+    initialRowGroupIndex?: number;
+    enableRowGroup?: boolean;
+    enableValue?: boolean;
+    aggFunc?: string | import('ag-grid-community').IAggFunc<any, any> | null | undefined;
+    initialAggFunc?: string | import('ag-grid-community').IAggFunc<any, any> | undefined;
+    defaultAggFunc?: string;
+    allowedAggFuncs?: string[];
+    showRowGroup?: string | boolean;
+    sortable?: boolean;
+    sort?: import('ag-grid-community').SortDirection;
+    initialSort?: import('ag-grid-community').SortDirection;
+    sortIndex?: number | null;
+    initialSortIndex?: number;
+    sortingOrder?: import('ag-grid-community').SortDirection[];
+    comparator?: ((valueA: any, valueB: any, nodeA: import('ag-grid-community').IRowNode<any>, nodeB: import('ag-grid-community').IRowNode<any>, isDescending: boolean) => number) | undefined;
+    unSortIcon?: boolean;
+    colSpan?: ((params: import('ag-grid-community').ColSpanParams<any, any>) => number) | undefined;
+    rowSpan?: ((params: import('ag-grid-community').RowSpanParams<any, any>) => number) | undefined;
+    spanRows?: boolean | ((params: import('ag-grid-community').SpanRowsParams<any, any>) => boolean) | undefined;
+    width?: number;
+    initialWidth?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    flex?: number;
+    initialFlex?: number;
+    resizable?: boolean;
+    suppressSizeToFit?: boolean;
+    suppressAutoSize?: boolean;
+    pivotValueColumn?: import('ag-grid-community').Column | null;
+    pivotTotalColumnIds?: string[];
+    suppressSpanHeaderHeight?: boolean;
+    headerName?: string;
+    headerValueGetter?: string | import('ag-grid-community').HeaderValueGetterFunc<any, any> | undefined;
+    headerTooltip?: string;
+    headerStyle?: import('ag-grid-community').HeaderStyle | import('ag-grid-community').HeaderStyleFunc<any, any> | undefined;
+    headerClass?: import('ag-grid-community').HeaderClass<any, any> | undefined;
+    suppressHeaderKeyboardEvent?: ((params: import('ag-grid-community').SuppressHeaderKeyboardEventParams<any, any>) => boolean) | undefined;
+    columnGroupShow?: import('ag-grid-community').ColumnGroupShowType;
+    toolPanelClass?: import('ag-grid-community').ToolPanelClass<any, any> | undefined;
+    suppressColumnsToolPanel?: boolean;
+    suppressFiltersToolPanel?: boolean;
+    tooltipComponent?: any;
+    tooltipComponentParams?: any;
+    pivotKeys?: string[];
+    cellAriaRole?: string;
+    context?: any;
+    wrapHeaderText?: boolean;
+    autoHeaderHeight?: boolean;
+    suppressHeaderContextMenu?: boolean;
+    filter?: any;
+    filterParams?: any;
+    floatingFilterComponent?: any;
+    floatingFilterComponentParams?: any;
+}[];

package/dist/src/index.d.ts

@@ -0,0 +1,64 @@
+import { ColumnsEditor } from './components/ColumnsEditor';
+import { DFViewer, DFViewerInfinite } from './components/DFViewerParts/DFViewerInfinite';
+import { WidgetDCFCell } from './components/DCFCell';
+import { BuckarooInfiniteWidget, DFViewerInfiniteDS, getKeySmartRowCache } from './components/BuckarooWidgetInfinite';
+import { parquetRead, parquetMetadata } from 'hyparquet';
+import { resolveDFData, resolveDFDataAsync, preResolveDFDataDict } from './components/DFViewerParts/resolveDFData';
+import { BuckarooStaticTable } from './components/BuckarooStaticTable';
+import { BuckarooServerView, buckarooWsUrl } from './server/BuckarooServerView';
+import { WebSocketModel } from './server/WebSocketModel';
+import { HistogramCell } from './components/DFViewerParts/HistogramCell';
+import { InfiniteEx } from './components/DFViewerParts/TableInfinite';
+import { DependentTabs } from './components/DependentTabs';
+import { OperationViewer } from './components/Operations';
+import { StatusBar } from './components/StatusBar';
+import { SampleButton, HeaderNoArgs, Counter } from './SampleComponent';
+import * as CommandUtils from "./components/CommandUtils";
+import * as utils from "./components/utils";
+import * as widgetUtils from "./widgetUtils";
+declare const _default: {
+    ColumnsEditor: typeof ColumnsEditor;
+    DependentTabs: typeof DependentTabs;
+    OperationViewer: ({ operations, setOperations, activeColumn, allColumns, command_config, }: {
+        operations: import('./components/OperationUtils').Operation[];
+        setOperations: import('./components/OperationUtils').SetOperationsFunc;
+        activeColumn: string;
+        allColumns: string[];
+        command_config: CommandUtils.CommandConfigT;
+    }) => import("react/jsx-runtime").JSX.Element;
+    WidgetDCFCell: typeof WidgetDCFCell;
+    DFViewer: typeof DFViewer;
+    DFViewerInfinite: typeof DFViewerInfinite;
+    DFViewerInfiniteDS: typeof DFViewerInfiniteDS;
+    StatusBar: typeof StatusBar;
+    HistogramCell: (props: {
+        api: import('ag-grid-community').GridApi;
+        colDef: import('ag-grid-community').ColDef;
+        column: import('ag-grid-community').Column;
+        context: import('ag-grid-community').Context;
+        value: any;
+    }) => import("react/jsx-runtime").JSX.Element;
+    CommandUtils: typeof CommandUtils;
+    utils: typeof utils;
+    BuckarooInfiniteWidget: typeof BuckarooInfiniteWidget;
+    getKeySmartRowCache: (model: any, setRespError: any) => import('./components/DFViewerParts/SmartRowCache').KeyAwareSmartRowCache;
+    InfiniteEx: () => import("react/jsx-runtime").JSX.Element;
+    widgetUtils: typeof widgetUtils;
+    SampleButton: ({ label, onClick }: {
+        label: string;
+        onClick: (ev: any) => void;
+    }) => import("react/jsx-runtime").JSX.Element;
+    HeaderNoArgs: () => import("react/jsx-runtime").JSX.Element;
+    Counter: () => import("react/jsx-runtime").JSX.Element;
+    parquetRead: typeof parquetRead;
+    parquetMetadata: typeof parquetMetadata;
+    resolveDFData: typeof resolveDFData;
+    resolveDFDataAsync: typeof resolveDFDataAsync;
+    preResolveDFDataDict: typeof preResolveDFDataDict;
+    BuckarooStaticTable: typeof BuckarooStaticTable;
+    BuckarooServerView: typeof BuckarooServerView;
+    buckarooWsUrl: typeof buckarooWsUrl;
+    WebSocketModel: typeof WebSocketModel;
+};
+export default _default;
+export { ColumnsEditor, DependentTabs, OperationViewer, WidgetDCFCell, DFViewer, DFViewerInfinite, DFViewerInfiniteDS, StatusBar, HistogramCell, CommandUtils, utils, BuckarooInfiniteWidget, getKeySmartRowCache, InfiniteEx, widgetUtils, SampleButton, HeaderNoArgs, Counter, parquetRead, parquetMetadata, resolveDFData, resolveDFDataAsync, preResolveDFDataDict, BuckarooStaticTable, BuckarooServerView, buckarooWsUrl, WebSocketModel, };

package/dist/src/server/BuckarooServerView.d.ts

@@ -0,0 +1,52 @@
+import * as React from "react";
+/**
+ * BuckarooServerView — embed a Buckaroo server session inside a React tree.
+ *
+ * This is the npm-module alternative to iframing `/s/<session-id>` from the
+ * Buckaroo server. The component opens a WebSocket to the server, waits for
+ * the `initial_state` message, builds the same model + row cache the
+ * standalone bundle uses, and renders the appropriate widget based on the
+ * server-reported `mode`.
+ *
+ *   import { BuckarooServerView } from "buckaroo-js-core";
+ *   import "buckaroo-js-core/style.css";
+ *
+ *   <BuckarooServerView wsUrl="ws://localhost:8700/ws/my-session" />
+ *
+ * The server's session decides the widget — pass `mode="viewer"` to
+ * /load for DFViewerInfiniteDS, `mode="buckaroo"` for the full UI. The host
+ * app does no widget-class selection; it only cares about which session to
+ * connect to.
+ */
+export type BuckarooServerMode = "viewer" | "buckaroo";
+export interface BuckarooServerMetadata {
+    path?: string;
+    rows?: number;
+    [k: string]: unknown;
+}
+export interface BuckarooServerViewProps {
+    /** Full WebSocket URL (ws:// or wss://). For a server at host H serving
+     *  session S, this is `ws://H/ws/S`. Use {@link buckarooWsUrl} if you
+     *  have an HTTP server URL + session id and want it derived. */
+    wsUrl: string;
+    /** Optional renderer for the "connecting" / pre-initial_state state.
+     *  Defaults to a plain "Connecting..." text. */
+    renderConnecting?: () => React.ReactNode;
+    /** Optional renderer for the error state. Receives the Error. Defaults
+     *  to a plain error message. */
+    renderError?: (err: Error) => React.ReactNode;
+    /** Called once the server sends its first `metadata` payload (typically
+     *  contains `path` and `rows`). Useful for host apps that want to mirror
+     *  the filename into their own title bar. */
+    onMetadata?: (metadata: BuckarooServerMetadata, prompt?: string) => void;
+    /** Optional inline style applied to the wrapping div. The component
+     *  defaults to `width:100%, height:100%`, so most consumers can rely on
+     *  the parent's flex / grid sizing. */
+    style?: React.CSSProperties;
+    /** Optional className on the wrapping div. */
+    className?: string;
+}
+/** Derive a Buckaroo server WebSocket URL from an HTTP server URL + session
+ *  id. Accepts `http://...`, `https://...`, or already-`ws[s]://` URLs. */
+export declare function buckarooWsUrl(serverUrl: string, sessionId: string): string;
+export declare function BuckarooServerView({ wsUrl, renderConnecting, renderError, onMetadata, style, className, }: BuckarooServerViewProps): React.ReactElement;

package/dist/src/server/BuckarooServerView.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/server/WebSocketModel.d.ts

@@ -0,0 +1,31 @@
+/**
+ * WebSocketModel — drop-in replacement for anywidget's model interface.
+ *
+ * Implements the subset of the model API that getKeySmartRowCache() and
+ * useModelState() depend on:
+ *   - model.send(msg)           → sends JSON over WebSocket
+ *   - model.on(event, handler)  → listens for events
+ *   - model.off(event, handler) → removes listener
+ *   - model.get(key)            → reads initial state
+ *   - model.set(key, value)     → updates local state
+ *   - model.save_changes()      → no-op (server doesn't need trait sync)
+ *
+ * Binary protocol (matching anywidget's msg + buffers pattern):
+ *   Server sends a JSON text frame (infinite_resp), then a binary frame (Parquet).
+ *   This class pairs them and emits "msg:custom" with (msg, [DataView]).
+ */
+export declare class WebSocketModel {
+    private ws;
+    private pendingMsg;
+    private handlers;
+    private state;
+    private pendingChanges;
+    constructor(ws: WebSocket, initialState: Record<string, any>);
+    send(msg: any): void;
+    get(key: string): any;
+    set(key: string, value: any): void;
+    save_changes(): void;
+    on(event: string, handler: Function): void;
+    off(event: string, handler: Function): void;
+    private emit;
+}

package/dist/src/stories/BuckarooWidgetTest.stories.d.ts

@@ -0,0 +1,12 @@
+import { StoryObj } from '@storybook/react';
+import { default as React } from 'react';
+declare const meta: {
+    title: string;
+    component: React.FC<{}>;
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Primary: Story;

package/dist/src/stories/ChartCell.stories.d.ts

@@ -0,0 +1,20 @@
+import { StoryObj } from '@storybook/react';
+import { ChartDisplayerA } from '../components/DFViewerParts/DFWhole';
+declare const meta: {
+    title: string;
+    component: ({ value, dispArgs }: {
+        value: any;
+        dispArgs: ChartDisplayerA;
+    }) => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+    argTypes: {};
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Primary: Story;
+export declare const Area: Story;
+export declare const Composed: Story;
+export declare const ComposedCustomColor: Story;

package/dist/src/stories/ColumnsEditor.stories.d.ts

@@ -0,0 +1,17 @@
+import { StoryObj } from '@storybook/react';
+import { ColumnsEditor } from '../components/ColumnsEditor';
+declare const meta: {
+    title: string;
+    component: typeof ColumnsEditor;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+};
+export default meta;
+type Story = StoryObj<typeof meta> | any;
+export declare const Default: Story;
+export declare const Empty: Story;
+export declare const SingleOperation: Story;
+export declare const DataCleaning: Story;
+export declare const ManyOperations: Story;

package/dist/src/stories/DFViewer.stories.d.ts

@@ -0,0 +1,26 @@
+import { StoryObj } from '@storybook/react';
+import { DFData, DFViewerConfig } from '../components/DFViewerParts/DFWhole';
+import { SetColumnFunc } from '../components/DFViewerParts/gridUtils';
+declare const meta: {
+    title: string;
+    component: ({ df_data, df_viewer_config, summary_stats_data, activeCol, setActiveCol, }: {
+        df_data: DFData;
+        df_viewer_config: DFViewerConfig;
+        summary_stats_data?: DFData;
+        activeCol?: [string, string];
+        setActiveCol?: SetColumnFunc;
+        outside_df_params?: any;
+        error_info?: string;
+    }) => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+    argTypes: {};
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Primary: Story;
+export declare const Tooltip: Story;
+export declare const ColorFromCol: Story;
+export declare const Chart: Story;

package/dist/src/stories/DFViewerInfiniteRaw.stories.d.ts

@@ -0,0 +1,24 @@
+import { StoryObj } from '@storybook/react';
+import { DFViewerConfig } from '../components/DFViewerParts/DFWhole';
+import { SetColumnFunc } from '../components/DFViewerParts/gridUtils';
+import { DatasourceOrRaw } from '../components/DFViewerParts/DFViewerDataHelper';
+declare const meta: {
+    title: string;
+    component: ({ data_wrapper, df_viewer_config, summary_stats_data, activeCol, setActiveCol, outside_df_params, error_info, }: {
+        data_wrapper: DatasourceOrRaw;
+        df_viewer_config: DFViewerConfig;
+        summary_stats_data?: any[];
+        activeCol?: [string, string];
+        setActiveCol?: SetColumnFunc;
+        outside_df_params?: any;
+        error_info?: string;
+    }) => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+    argTypes: {};
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Primary: Story;

package/dist/src/stories/DFViewerInfiniteShadow.stories.d.ts

@@ -0,0 +1,31 @@
+import { StoryObj } from '@storybook/react';
+import { DFViewerConfig } from '../components/DFViewerParts/DFWhole';
+declare const meta: {
+    title: string;
+    component: ({ data, df_viewer_config, secondary_df_viewer_config, summary_stats_data, outside_df_params, }: {
+        data: any[];
+        df_viewer_config: DFViewerConfig;
+        secondary_df_viewer_config?: DFViewerConfig;
+        summary_stats_data?: any[];
+        outside_df_params?: any;
+    }) => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+    argTypes: {};
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Primary: Story;
+export declare const Large: Story;
+export declare const PinnedRows: Story;
+export declare const ColorMapExample: Story;
+export declare const MultiIndex: Story;
+export declare const ThreeLevelColumnIndex: Story;
+export declare const FailingInMarimo: Story;
+export declare const MedDFVHeight: Story;
+export declare const get_multiindex_with_names_index_df: Story;
+export declare const get_multiindex_index_df: Story;
+export declare const get_multiindex_index_multiindex_with_names_cols_df: Story;
+export declare const get_multiindex3_index_df: Story;

package/dist/src/stories/HistogramCell.stories.d.ts

@@ -0,0 +1,18 @@
+import { StoryObj } from '@storybook/react';
+declare const meta: {
+    title: string;
+    component: ({ histogramArr, context, className, colorScheme }: {
+        histogramArr: import('../components/DFViewerParts/HistogramCell').HistogramBar[];
+        context: any;
+        className?: string;
+        colorScheme?: "light" | "dark";
+    }) => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+    argTypes: {};
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Primary: Story;

package/dist/src/stories/InheritEdgeCases.stories.d.ts

@@ -0,0 +1,12 @@
+import { StoryObj } from '@storybook/react';
+declare const meta: {
+    title: string;
+    component: () => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const MixedTypes: Story;
+export declare const ExtremeNumbers: Story;

package/dist/src/stories/InheritPinnedRows.stories.d.ts

@@ -0,0 +1,13 @@
+import { StoryObj } from '@storybook/react';
+declare const meta: {
+    title: string;
+    component: () => import("react/jsx-runtime").JSX.Element;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const Primary: Story;
+export declare const SummaryView: Story;