kepler.gl 3.1.0 → 3.1.1

package/README.md

@@ -33,7 +33,7 @@
 
 [Kepler.gl][web] is a data-agnostic, high-performance web-based application for visual exploration of large-scale geolocation data sets. Built on top of [MapLibre GL](https://maplibre.org/) and [deck.gl](https://deck.gl/), kepler.gl can render millions of points representing thousands of trips and perform spatial aggregations on the fly.
 
-Kepler.gl is also a React component that uses [Redux](https://redux.js.org/) to manage its state and data flow. It can be embedded into other React-Redux applications and is highly customizable. For information on how to embed kepler.gl in your app take a look at this step-by-step [tutorial][vis-academy] on vis.academy.
+Kepler.gl is also a React component that uses [Redux](https://redux.js.org/) to manage its state and data flow. It can be embedded into other React-Redux applications and is highly customizable. For information on how to embed kepler.gl in your app take a look at this step-by-step [tutorial](https://github.com/uber-archive/vis-academy/blob/master/src/docs/kepler.gl/0-setup.md) on vis.academy.
 
 ## Links
 
@@ -149,122 +149,32 @@ const Map = props => (
 );
 ```
 
-#### Props
-
-##### `id` (String, required)
-
-- Default: `map`
-
-The id of this KeplerGl instance. `id` is required if you have multiple
-KeplerGl instances in your app. It defines the prop name of the KeplerGl state that is
-stored in the KeplerGl reducer. For example, the state of the KeplerGl component with id `foo` is
-stored in `state.keplerGl.foo`.
-
-In case you create multiple kepler.gl instances using the same id, the kepler.gl state defined by the entry will be
-overridden by the latest instance and reset to a blank state.
-
-##### `mapboxApiAccessToken` (String, required\*)
-
-- Default: `undefined`
-
-By default, kepler.gl uses mapbox-gl.js to render its base maps. You can create a free account at [mapbox][mapbox] and create a token at [www.mapbox.com/account/access-tokens][mapbox-token].
-
-If you replaced kepler.gl default map styles with your own, and they are not Mapbox styles. `mapboxApiAccessToken` will not be required.
-
-Read more about [Custom Map Styles][custom-map-styles].
-
-##### `getState` (Function, optional)
-
-- Default: `state => state.keplerGl`
-
-The path to the root keplerGl state in your reducer.
-
-##### `width` (Number, optional)
-
-- Default: `800`
-
-Width of the KeplerGl UI.
-
-##### `height` (Number, optional)
-
-- Default: `800`
-
-##### `appName` (String, optional)
-
-- Default: `Kepler.Gl`
-
-App name displayed in side panel header
-
-##### `version` (String, optional)
-
-- Default: `v1.0`
-
-version displayed in side panel header
-
-##### `onSaveMap` (Function, optional)
-
-- Default: `undefined`
-
-Action called when click Save Map Url in side panel header.
-
-##### `onViewStateChange` (Function, optional)
-
-- Default: `undefined`
-- Parameter: `viewState` - An updated view state object containing parameters such as longitude, latitude, zoom etc
-
-Action triggered when map viewport is updated.
-
-##### `getMapboxRef(mapbox, index)` (Function, optional)
-
-- Default: `undefined`
-
-Function called when `KeplerGL` adds or removes a `MapContainer` component having an inner Mapbox map.
-
-The `mapbox` argument is an [`MapRef`](https://visgl.github.io/react-map-gl/docs/api-reference/types#mapref) when added or `null` when removed.
-
-The `index` argument is 0 for a single map or 1 for an additional map (since `KeplerGL` supports an optional split map view).
-
-##### `actions` (Object, optional)
-
-- Default: `{}`
-
-Actions creators to replace default kepler.gl action creator. Only use custom action when you want to modify action payload.
-
-##### `mint` (Boolean, optional)
-
-- Default: `true`
-
-Whether to load a fresh empty state when component is mounted. when parse `mint: true` kepler.gl component will always load a fresh state when re-mount the same component, state inside this component will be destroyed once its unmounted.
-By Parsing `mint: false` kepler.gl will keep the component state in the store even when it is unmounted, and use it as initial state when re-mounted again. This is useful when mounting kepler.gl in a modal, and keep the same map when re-open.
-
-Read more about [Components][components].
-
-##### `theme` (Object | String, optional)
-
-- default: `null`
-
-One of `"dark"`, `"light"` or `"base"`
-You can pass theme name or object used to customize Kepler.gl style. Kepler.gl provide an `'light'` theme besides the default 'dark' theme. When pass in a theme object Kepler.gl will use the value passed as input to override values from [theme](https://github.com/keplergl/kepler.gl/blob/master/src/styles/base.js).
-
-Read more about [Custom Theme][custom-theme]
-
-#### `mapboxApiUrl` (String, optional)
-
-- Default: `https://api.mapbox.com`
-
-If you are using your own mapbox tile server, you can pass in your own tile server api url.
-
-#### `mapStylesReplaceDefault` (Boolean, optional)
-
-- Default: `false`
-
-kepler.gl provide 4 map styles to choose from. Pass `true` if you want to supply your own `mapStyles`. See Below.
-
-#### `mapStyles` (Array, optional)
-
-- Default: `[]`
-
-You can supply additional map styles to be displayed in [map style selection panel](https://github.com/keplergl/kepler.gl/blob/master/docs/user-guides/f-map-styles/1-base-map-styles.md). By default, additional map styles will be added to default map styles. If pass `mapStylesReplaceDefault: true`, they will replace the default ones. kepler.gl will attempt to group layers of your style based on its `id` naming convention and use it to allow toggle visibility of [base map layers](https://github.com/keplergl/kepler.gl/blob/master/docs/user-guides/f-map-styles/2-map-layers.md). Supply your own `layerGroups` to override default for more accurate layer grouping.
+### Props
+
+| Prop Name                     | Type        | Default Value              | Description                                                                                                                                                                                                             |
+|-------------------------------|-------------|----------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `id`                           | String      | `map`                      | The unique identifier for the KeplerGl instance. Required when multiple KeplerGl instances exist. It maps to the state in the reducer (e.g. component with id `foo` can be found in`state.keplerGl.foo`).               |
+| `mapboxApiAccessToken`         | String      | `undefined`                | API token for Mapbox, used for rendering base maps. Create a free token at [Mapbox](https://www.mapbox.com).                                                                                                            |
+| `getState`                     | Function    | `state => state.keplerGl`   | Function that specifies the path to the root KeplerGl state in the reducer.                                                                                                                                             |
+| `width`                        | Number      | `800`                      | The width of the KeplerGl UI in pixels.                                                                                                                                                                                 |
+| `height`                       | Number      | `800`                      | The height of the KeplerGl UI in pixels.                                                                                                                                                                                |
+| `appName`                      | String      | `Kepler.Gl`                | The app name displayed in the side panel header.                                                                                                                                                                        |
+| `version`                      | String      | `v1.0`                     | The version displayed in the side panel header.                                                                                                                                                                         |
+| `onSaveMap`                    | Function    | `undefined`                | A function called when the "Save Map URL" in side panel header is clicked.                                                                                                                                              |
+| `onViewStateChange`            | Function    | `undefined`                | Triggered when the map viewport is updated. Receives `viewState` parameter with updated values like longitude, latitude, zoom, etc.                                                                                     |
+| `getMapboxRef(mapbox, index)`  | Function    | `undefined`                | Called when `KeplerGl` adds or removes a MapContainer with an inner Mapbox map. `mapbox` is a `MapRef` when added, or `null` when removed. `index` is `0` for the first map and `1` for the second map in a split view. |
+| `actions`                      | Object      | `{}`                       | Custom action creators to override the default KeplerGl action creators. Only use custom action when you want to modify action payload.                                                                                 |
+| `mint`                         | Boolean     | `true`                     | Determines whether to load a fresh empty state when mounted. When `false`, the state persists across remounts. Useful for modal use cases.                                                                              |
+| `theme`                        | Object/String| `null`                     | Set to `"dark"`, `"light"`, or `"base"`, or pass a theme object to customize KeplerGl’s style.                                                                                                                          |
+| `mapboxApiUrl`                 | String      | `https://api.mapbox.com`    | The Mapbox API URL if you are using a custom Mapbox tile server.                                                                                                                                                        |
+| `mapStylesReplaceDefault`      | Boolean     | `false`                    | Set to `true` to replace default map styles with custom ones. (see ```mapStyles``` prop)                                                                                                                                      |
+| `mapStyles`                    | Array       | `[]`                       | An array of [custom map styles](#example-custom-map-style)  for the map style selection panel. Styles replace the default ones if `mapStylesReplaceDefault` is `true`.                                                  |
+| `initialUiState`               | Object      | `undefined`                | The initial UI state applied to the `uiState` reducer.                                                                                                                                                                  |
+| `localeMessages`               | Object      | `undefined`                | Used to modify or add new translations. Read more about [Localization][localization].                                                                                                                                   |
+
+#### Example Custom Map Style
+
+You can supply additional map styles to be displayed in [map style selection panel](https://github.com/keplergl/kepler.gl/blob/master/docs/user-guides/f-map-styles/1-base-map-styles.md). By default, additional map styles will be added to default map styles. If you pass `mapStylesReplaceDefault: true`, they will replace the default ones. kepler.gl will attempt to group layers of your style based on its `id` naming convention and use it to allow toggle visibility of [base map layers](https://github.com/keplergl/kepler.gl/blob/master/docs/user-guides/f-map-styles/2-map-layers.md). Supply your own `layerGroups` to override default for more accurate layer grouping.
 
 Each `mapStyles` should has the following properties:
 
@@ -288,7 +198,6 @@ const mapStyles = [
         defaultVisibility: true
       },
       {
-        // adding this will keep the 3d building option
         slug: '3d building',
         filter: () => false,
         defaultVisibility: false
@@ -298,20 +207,6 @@ const mapStyles = [
 ];
 ```
 
-Read more about [Custom Map Styles][custom-map-styles].
-
-#### `initialUiState` (object, optional)
-
-- Default: `undefined`
-
-Intial UI State applied to uiState reducer, value will be shallow merged with default [`INITIAL_UI_STATE`](https://docs.kepler.gl/docs/api-reference/reducers/ui-state#initial_ui_state)
-
-#### `localeMessages` (object, optional)
-
-- Default: `undefined` Modify default translation or add new translation
-
-Read more about [Localization][localization].
-
 ### 3. Dispatch custom actions to `keplerGl` reducer.
 
 One advantage of using the reducer over React component state to handle keplerGl state is the flexibility

package/dist/src/common-utils/src/data-type.d.ts

@@ -1,4 +1,4 @@
-import { RowData, Field } from '@kepler.gl/types';
+import { ArrowTableInterface, ApacheVectorInterface, RowData, Field } from '@kepler.gl/types';
 export declare const ACCEPTED_ANALYZER_TYPES: any[];
 /**
  * Getting sample data for analyzing field type.
@@ -8,6 +8,14 @@ export declare function getSampleForTypeAnalyze({ fields, rows, sampleCount }: {
     rows: unknown[][] | RowData;
     sampleCount?: number;
 }): RowData;
+/**
+ * Getting sample data for analyzing field type for Arrow tables.
+ * @param table Arrow table or an array of vectors.
+ * @param fields Field names.
+ * @param sampleCount Number of sample rows to get.
+ * @returns Sample rows.
+ */
+export declare function getSampleForTypeAnalyzeArrow(table: ArrowTableInterface | ApacheVectorInterface[], fields: string[], sampleCount?: number): any[];
 /**
  * Convert type-analyzer output to kepler.gl field types
  *

package/dist/src/components/src/common/data-table/header-cell.d.ts

@@ -20,6 +20,7 @@ declare type HeaderCellProps = {
     props: DataTableProps;
     toggleMoreOptions: (moreOptionsColumn: string) => void;
     moreOptionsColumn: null | string;
+    style: CSSProperties;
 };
 declare const HeaderCellFactory: {
     (FieldToken: React.FC<FieldTokenProps>): ({ cellInfo, columns, isPinned, props, toggleMoreOptions, moreOptionsColumn }: HeaderCellProps) => React.JSX.Element;

package/dist/src/components/src/common/data-table/index.d.ts

@@ -94,6 +94,7 @@ declare namespace DataTableFactory {
             props: DataTableProps;
             toggleMoreOptions: (moreOptionsColumn: string) => void;
             moreOptionsColumn: string | null;
+            style: React.CSSProperties;
         }) => React.JSX.Element;
         deps: typeof import("../field-token").default[];
     }[];

package/dist/src/components/src/common/file-uploader/file-drop.d.ts

@@ -19,36 +19,5 @@ export declare type FileDropProps = {
     onFrameDrop?: (event: any) => void;
     children?: ReactNode;
 };
-/** @typedef {import('./file-drop').FileDropProps} FileDropProps */
-/** @augments React.PureComponent<FileDropProps> */
-declare class FileDrop extends React.PureComponent<FileDropProps> {
-    static isIE: () => any;
-    static eventHasFiles: (event: any) => boolean;
-    static defaultProps: {
-        dropEffect: string;
-        frame: any;
-        className: string;
-        targetClassName: string;
-        draggingOverFrameClassName: string;
-        draggingOverTargetClassName: string;
-    };
-    frameDragCounter: number;
-    state: {
-        draggingOverFrame: boolean;
-        draggingOverTarget: boolean;
-    };
-    componentDidMount(): void;
-    componentDidUpdate(prevProps: any): void;
-    componentWillUnmount(): void;
-    resetDragging: () => void;
-    handleWindowDragOverOrDrop: (event: any) => void;
-    handleFrameDrag: (event: any) => void;
-    handleFrameDrop: (event: any) => void;
-    handleDragOver: (event: any) => void;
-    handleDragLeave: (event: any) => void;
-    handleDrop: (event: any) => void;
-    stopFrameListeners: (frame: any) => void;
-    startFrameListeners: (frame: any) => void;
-    render(): React.JSX.Element;
-}
+declare const FileDrop: ({ dropEffect, frame, className, targetClassName, draggingOverFrameClassName, draggingOverTargetClassName, onDragOver, onDragLeave, onDrop, onFrameDragEnter, onFrameDragLeave, onFrameDrop, children }: FileDropProps) => React.JSX.Element;
 export default FileDrop;

package/dist/src/components/src/common/item-selector/dropdown-list.d.ts

@@ -14,7 +14,7 @@ export declare type ListItemProps<Option> = {
     disabled?: boolean;
     light?: boolean;
 };
-export declare const ListItem: ({ value, displayOption, disabled, light }: ListItemProps<any>) => React.JSX.Element;
+export declare const ListItem: ({ value, displayOption, disabled }: ListItemProps<any>) => React.JSX.Element;
 export declare type DropdownListWrapperProps = BaseComponentProps & {
     light?: boolean;
 };
@@ -47,7 +47,7 @@ interface DropdownListState {
 export default class DropdownList extends Component<DropdownListProps, DropdownListState> {
     static defaultProps: {
         customClasses: {};
-        customListItemComponent: ({ value, displayOption, disabled, light }: ListItemProps<any>) => React.JSX.Element;
+        customListItemComponent: ({ value, displayOption, disabled }: ListItemProps<any>) => React.JSX.Element;
         customListHeaderComponent: null;
         allowCustomValues: number;
         customValues: never[];

package/dist/src/components/src/common/item-selector/item-selector.d.ts

@@ -47,7 +47,7 @@ declare class ItemSelectorUnmemoized extends Component<ItemSelectorProps<any>> {
         closeOnSelect: boolean;
         searchable: boolean;
         DropDownRenderComponent: typeof DropdownList;
-        DropDownLineItemRenderComponent: ({ value, displayOption, disabled, light }: import("./dropdown-list").ListItemProps<any>) => React.JSX.Element;
+        DropDownLineItemRenderComponent: ({ value, displayOption, disabled }: import("./dropdown-list").ListItemProps<any>) => React.JSX.Element;
         DropDownWrapperComponent: IStyledComponent<"web", DropdownWrapperProps>;
         reorderItems: undefined;
         className: string;

package/dist/src/components/src/common/item-selector/typeahead.d.ts

@@ -95,7 +95,7 @@ declare class Typeahead extends Component<TypeaheadProps, TypeaheadState> {
         inputDisplayOption: null;
         defaultClassNames: boolean;
         customListComponent: typeof DropdownList;
-        customListItemComponent: ({ value, displayOption, disabled, light }: import("./dropdown-list").ListItemProps<any>) => React.JSX.Element;
+        customListItemComponent: ({ value, displayOption, disabled }: import("./dropdown-list").ListItemProps<any>) => React.JSX.Element;
         inputIcon: typeof Search;
         customListHeaderComponent: null;
         showOptionsWhenEmpty: boolean;

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

@@ -1,6 +1,13 @@
 import React from 'react';
 import { IntlShape } from 'react-intl';
 import { Viewport } from '@kepler.gl/types';
+/**
+ * Tests if a given query string contains valid coordinates.
+ * @param query The input string to test for coordinates.
+ * @returns A tuple where:
+ *   - If valid, returns `[true, longitude, latitude]`.
+ *   - If invalid, returns `[false, query]`.
+ */
 export declare const testForCoordinates: (query: string) => [true, number, number] | [false, string];
 export interface Result {
     center: [number, number];

package/dist/src/components/src/geocoder-panel.d.ts

@@ -1,4 +1,4 @@
-import { ComponentType } from 'react';
+import React from 'react';
 import { AddDataToMapOptions, MapState, ProtoDataset, UiState } from '@kepler.gl/types';
 import { ActionHandler, removeDataset, updateMap, updateVisData } from '@kepler.gl/actions';
 import { MapViewState } from '@deck.gl/core/typed';
@@ -24,5 +24,5 @@ interface GeocoderPanelProps {
     index: number;
     unsyncedViewports: boolean;
 }
-export default function GeocoderPanelFactory(): ComponentType<GeocoderPanelProps>;
+export default function GeocoderPanelFactory(): React.FC<GeocoderPanelProps>;
 export {};

package/dist/src/components/src/hooks/use-fetch-vector-tile-metadata.d.ts

@@ -1,9 +1,10 @@
-import { /* MVTSource,*/ TileJSON } from '@loaders.gl/mvt';
+import { TileJSON } from '@loaders.gl/mvt';
 import { PMTilesMetadata } from '@loaders.gl/pmtiles';
 import { RemoteTileFormat } from '@kepler.gl/constants';
 import { VectorTileMetadata } from '@kepler.gl/table';
 declare type FetchVectorTileMetadataProps = {
-    url: string | null;
+    metadataUrl: string | null;
+    tilesetUrl: string | null;
     remoteTileFormat: RemoteTileFormat;
     process?: (json: PMTilesMetadata | TileJSON) => VectorTileMetadata | Error | null;
 };
@@ -13,5 +14,5 @@ declare type FetchVectorTileMetadataReturn = {
     error: Error | null;
 };
 /** Hook to fetch and return mvt or pmtiles metadata. */
-export default function useFetchVectorTileMetadata({ remoteTileFormat, url, process }: FetchVectorTileMetadataProps): FetchVectorTileMetadataReturn;
+export default function useFetchVectorTileMetadata({ remoteTileFormat, tilesetUrl, metadataUrl, process }: FetchVectorTileMetadataProps): FetchVectorTileMetadataReturn;
 export {};

package/dist/src/constants/src/default-settings.d.ts

@@ -569,7 +569,7 @@ export declare const FIELD_OPTS: {
             size: never[];
         };
         format: {
-            legend: (d: any) => string;
+            legend: () => string;
             tooltip: never[];
         };
     };
@@ -843,4 +843,17 @@ export declare const POSTPROCESSING_EFFECTS: {
 export declare const EFFECT_DESCRIPTIONS: EffectDescription[];
 export declare type EffectType = 'ink' | 'brightnessContrast' | 'hueSaturation' | 'vibrance' | 'sepia' | 'dotScreen' | 'colorHalftone' | 'noise' | 'triangleBlur' | 'zoomBlur' | 'tiltShift' | 'edgeWork' | 'vignette' | 'magnify' | 'hexagonalPixelate' | 'lightAndShadow';
 export declare const SYNC_TIMELINE_MODES: Record<string, SyncTimelineMode>;
+export declare const GEOARROW_METADATA_KEY = "ARROW:extension:name";
+/**
+ * Enum holding GeoArrow extension type names
+ */
+export declare enum GEOARROW_EXTENSIONS {
+    POINT = "geoarrow.point",
+    LINESTRING = "geoarrow.linestring",
+    POLYGON = "geoarrow.polygon",
+    MULTIPOINT = "geoarrow.multipoint",
+    MULTILINESTRING = "geoarrow.multilinestring",
+    MULTIPOLYGON = "geoarrow.multipolygon",
+    WKB = "geoarrow.wkb"
+}
 export {};

package/dist/src/deckgl-arrow-layers/src/constants.d.ts

@@ -1,13 +1 @@
-/**
- * Enum holding GeoArrow extension type names
- */
-export declare enum EXTENSION_NAME {
-    POINT = "geoarrow.point",
-    LINESTRING = "geoarrow.linestring",
-    POLYGON = "geoarrow.polygon",
-    MULTIPOINT = "geoarrow.multipoint",
-    MULTILINESTRING = "geoarrow.multilinestring",
-    MULTIPOLYGON = "geoarrow.multipolygon",
-    WKB = "geoarrow.wkb"
-}
 export declare const DEFAULT_COLOR: [number, number, number, number];

package/dist/src/deckgl-arrow-layers/src/index.d.ts

@@ -1,4 +1,3 @@
-export { EXTENSION_NAME } from './constants';
 export { GeoArrowScatterplotLayer } from './layers/geo-arrow-scatterplot-layer';
 export { GeoArrowTextLayer } from './layers/geo-arrow-text-layer';
 export { GeoArrowArcLayer } from './layers/geo-arrow-arc-layer';

package/dist/src/deckgl-arrow-layers/src/utils/utils.d.ts

@@ -6,6 +6,16 @@ export declare function findGeometryColumnIndex(schema: arrow.Schema, extensionN
  * Returns `true` if the input is a reference to a column in the table
  */
 export declare function isColumnReference(input: any): input is string;
+/**
+ * Convert geoarrow Struct coordinates to FixedSizeList coords
+ *
+ * The GeoArrow spec allows for either separated or interleaved coords, but at
+ * this time deck.gl only supports interleaved.
+ */
+export declare function convertStructToFixedSizeList(coords: arrow.Data<arrow.FixedSizeList<arrow.Float64>> | arrow.Data<arrow.Struct<{
+    x: arrow.Float64;
+    y: arrow.Float64;
+}>>): arrow.Data<arrow.FixedSizeList<arrow.Float64>>;
 declare type AssignAccessorProps = {
     /** The object on which to assign the resolved accesor */
     props: Record<string, any>;
@@ -34,10 +44,11 @@ export declare function assignAccessor(args: AssignAccessorProps): void;
  * @param input: the input array to expand
  * @param size : the number of nested elements in the input array per geometry. So for example, for RGB data this would be 3, for RGBA this would be 4. For radius, this would be 1.
  * @param geomOffsets : an offsets array mapping from the geometry to the coordinate indexes. So in the case of a LineStringArray, this is retrieved directly from the GeoArrow storage. In the case of a PolygonArray, this comes from the resolved indexes that need to be given to the SolidPolygonLayer anyways.
+ * @param numPositions : end position in geomOffsets, as geomOffsets can potentially contain preallocated zeroes in the end of the buffer.
  *
  * @return  {TypedArray} values expanded to be per-coordinate
  */
-export declare function expandArrayToCoords<T extends TypedArray>(input: T, size: number, geomOffsets: Int32Array): T;
+export declare function expandArrayToCoords<T extends TypedArray>(input: T, size: number, geomOffsets: Int32Array, numPositions?: number): T;
 /**
  * Get a geometry vector with the specified extension type name from the table.
  */

package/dist/src/duckdb/src/components/preview-data-panel.d.ts

@@ -1,3 +1,4 @@
+import * as arrow from 'apache-arrow';
 import React, { CSSProperties } from 'react';
 declare type BaseComponentProps = {
     className?: string;
@@ -18,8 +19,12 @@ export declare type DataTableStyle = {
     font?: string;
     optionsButton?: number;
 };
+export declare type QueryResult = {
+    table: arrow.Table;
+    tableDuckDBTypes: Record<string, string>;
+};
 export declare type PreviewDataPanelProps = BaseComponentProps & {
-    result: any;
+    result: QueryResult;
     rowsToCalculatePreview?: number;
     theme?: any;
     setColumnDisplayFormat?: (formats: {
@@ -27,7 +32,7 @@ export declare type PreviewDataPanelProps = BaseComponentProps & {
     }) => void;
     defaultPinnedColumns?: string[];
     dataTableStyle: DataTableStyle;
-    onAddResultToMap: (result: any) => void;
+    onAddResultToMap: (result: QueryResult) => void;
 };
 export declare const PreviewDataPanel: React.FC<PreviewDataPanelProps>;
 export {};

package/dist/src/duckdb/src/components/schema-panel.d.ts

@@ -1,4 +1,13 @@
 import React from 'react';
-export declare const SchemaPanel: ({ setTableSchema }: {
-    setTableSchema: any;
-}) => React.JSX.Element;
+export declare type SchemaSuggestion = {
+    column_name: string;
+    table_name: string;
+};
+declare type SchemaPanelProps = {
+    setTableSchema: (tableSchema: SchemaSuggestion[]) => void;
+    droppedFile: File | null;
+    schemaUpdateTrigger: number;
+};
+export declare const SchemaPanelDropMessage: () => React.JSX.Element;
+export declare const SchemaPanel: ({ setTableSchema, droppedFile, schemaUpdateTrigger }: SchemaPanelProps) => React.JSX.Element;
+export {};

package/dist/src/duckdb/src/processors/data-processor.d.ts

@@ -10,6 +10,7 @@ export declare type ProcessorResult = {
     rows: RowData;
     fields: ProtoDatasetField[];
 };
+export declare const COLUMN_TYPES_PRIORITIES: string[];
 export declare function columnTypeToFieldType(columnType: string): string | null;
 export declare function fieldTypeToColumnType(fieldType: string): string | null;
 export declare function processKeplerglJSONforDuckDb(keplerJson: any): Promise<ReturnType<typeof processKeplerglJSON>>;

package/dist/src/duckdb/src/table/duckdb-table-utils.d.ts

@@ -1,4 +1,65 @@
+import * as arrow from 'apache-arrow';
 import { DataType } from 'apache-arrow/type';
+import { AsyncDuckDBConnection } from '@duckdb/duckdb-wasm';
+import { ProtoDatasetField } from '@kepler.gl/types';
+export declare const SUPPORTED_DUCKDB_DROP_EXTENSIONS: string[];
+export declare type DuckDBColumnDesc = {
+    name: string;
+    type: string;
+};
+/**
+ * Queries a DuckDB table for the schema description.
+ * @param connection An active DuckDB connection.
+ * @param tableName A name of DuckDB table to query.
+ * @returns An array of column names and DuckDB types.
+ */
+export declare function getDuckDBColumnTypes(connection: AsyncDuckDBConnection, tableName: string): Promise<DuckDBColumnDesc[]>;
+/**
+ * Generates a mapping of column names to their corresponding DuckDB data types.
+ * @param columns An array of column descriptions from DuckDB. Check getDuckDBColumnTypes.
+ * @returns A record where keys are column names and values are their data types.
+ */
+export declare function getDuckDBColumnTypesMap(columns: DuckDBColumnDesc[]): Record<string, string>;
+/**
+ * Constructs an SQL query to select all columns from a given table,
+ * converting specified columns to Well-Known Binary (WKB) format using ST_AsWKB.
+ * @param tableName The name of the table from which to select data.
+ * @param columnsToConvertToWKB An array of column names that should be converted to WKB format.
+ * @returns The constructed SQL query.
+ */
+export declare function constructST_asWKBQuery(tableName: string, columnsToConvertToWKB: string[]): string;
+/**
+ * Finds the names of columns that have a GEOMETRY type.
+ * @param columns An array of column descriptors from a DuckDB table.
+ * @returns An array of column names that are of type GEOMETRY.
+ */
+export declare function getGeometryColumns(columns: DuckDBColumnDesc[]): string[];
+/**
+ * Sets the GeoArrow WKB extension metadata for columns of type GEOMETRY in an Arrow table.
+ * @param table The Apache Arrow table whose schema fields will be modified.
+ * @param columns An array of column descriptors from a DuckDB table.
+ */
+export declare function setGeoArrowWKBExtension(table: arrow.Table, columns: DuckDBColumnDesc[]): void;
+/**
+ * Creates an arrow table from an array of arrow vectors and fields.
+ * @param columns An array of arrow vectors.
+ * @param fields An array of fields per arrow vector.
+ * @param arrowSchema Optional arrow table schema when available.
+ * @returns An arrow table.
+ */
+export declare const restoreArrowTable: (columns: arrow.Vector[], fields: ProtoDatasetField[], arrowSchema?: arrow.Schema) => arrow.Table<any>;
+/**
+ * DuckDb throws when geoarrow extensions are present in metadata.
+ * @param table An arrow table to clear from extensions.
+ * @returns A map of removed per field geoarrow extensions.
+ */
+export declare const removeUnsupportedExtensions: (table: arrow.Table) => Record<string, string>;
+/**
+ * Restore removed metadata extensions after a call to removeUnsupportedExtensions.
+ * @param table An arrow table to restore geoarrow extensions.
+ * @param removedExtensions A map of per field geoarrow extensions to restore.
+ */
+export declare const restoreUnsupportedExtensions: (table: arrow.Table, removedExtensions: Record<string, string>) => void;
 /** Checks whether the given Apache Arrow JS type is a Point data type */
 export declare function isGeoArrowPoint(type: DataType): boolean;
 /** Checks whether the given Apache Arrow JS type is a Point data type */
@@ -11,3 +72,48 @@ export declare function isGeoArrowMultiPoint(type: DataType): boolean;
 export declare function isGeoArrowMultiLineString(type: DataType): boolean;
 /** Checks whether the given Apache Arrow JS type is a Polygon data type */
 export declare function isGeoArrowMultiPolygon(type: DataType): boolean;
+/**
+ * Checks if the given SQL query is a SELECT query by using the EXPLAIN command.
+ * @param connection The DuckDB connection instance.
+ * @param query The SQL query to check.
+ * @returns Resolves to `true` if the query is a SELECT statement, otherwise `false`.
+ */
+export declare function checkIsSelectQuery(connection: AsyncDuckDBConnection, query: string): Promise<boolean>;
+/**
+ * Split a string with potentially multiple SQL queries (separated as usual by ';') into an array of queries.
+ * This implementation:
+ *  - Handles single and double quoted strings with proper escaping
+ *  - Ignores semicolons in line comments (--) and block comments (slash asterisk)
+ *  - Trims whitespace from queries
+ *  - Handles SQL-style escaped quotes ('' inside strings)
+ *  - Returns only non-empty queries
+ * @param input A string with potentially multiple SQL queries.
+ * @returns An array of queries.
+ */
+export declare function splitSqlStatements(input: string): string[];
+/**
+ * Removes SQL comments from a given SQL string.
+ * @param sql The SQL query string from which comments should be removed.
+ * @returns The cleaned SQL string without comments.
+ */
+export declare function removeSQLComments(sql: string): string;
+/**
+ * Drops a table if it exists in the DuckDB database.
+ * @param connection The DuckDB connection instance.
+ * @param tableName The name of the table to drop.
+ * @returns A promise that resolves when the operation is complete.
+ * @throws Logs an error if the table drop operation fails.
+ */
+export declare const dropTableIfExists: (connection: AsyncDuckDBConnection, tableName: string) => Promise<void>;
+/**
+ * Imports a file into DuckDB as a table, supporting multiple formats from SUPPORTED_DUCKDB_DROP_EXTENSIONS.
+ * @param file The file to be imported.
+ * @returns A promise that resolves when the file has been processed into a DuckDB table.
+ */
+export declare function tableFromFile(file: File | null): Promise<null | Error>;
+/**
+ * Sanitizes a file name to be a valid DuckDB table name.
+ * @param fileName The input file name to be sanitized.
+ * @returns A valid DuckDB table name.
+ */
+export declare function sanitizeDuckDBTableName(fileName: string): string;

package/dist/src/duckdb/src/table/duckdb-table.d.ts

@@ -3,12 +3,14 @@ import { AsyncDuckDB, AsyncDuckDBConnection } from '@duckdb/duckdb-wasm';
 import { KeplerTable } from '@kepler.gl/table';
 import { ProcessorResult } from '../processors/data-processor';
 declare type ImportDataToDuckProps = {
-    data: ProcessorResult;
+    data: ProcessorResult & {
+        arrowSchema: arrow.Schema;
+    };
     db: AsyncDuckDB;
     c: AsyncDuckDBConnection;
 };
 declare type ImportDataToDuckResult = {
-    addWKBMetadata?: Record<string, boolean>;
+    geoarrowMetadata?: Record<string, string>;
     useNewFields?: boolean;
 };
 export declare class KeplerGlDuckDbTable extends KeplerTable {
@@ -19,7 +21,7 @@ export declare class KeplerGlDuckDbTable extends KeplerTable {
     constructor(props: any);
     importRowData({ data, db, c }: ImportDataToDuckProps): Promise<void>;
     importGeoJsonData({ data, db, c }: ImportDataToDuckProps): Promise<ImportDataToDuckResult>;
-    importArrowData({ data, db, c }: ImportDataToDuckProps): Promise<ImportDataToDuckResult>;
+    importArrowData({ data, c }: ImportDataToDuckProps): Promise<ImportDataToDuckResult>;
     /**
      * Creates a table from data, returns an arrow table with the data
      * @param data