@carto/api-client 0.5.0-alpha.7 → 0.5.0-alpha.8

package/build/api-client.cjs

@@ -433,7 +433,6 @@ __export(src_exports, {
   WidgetSource: () => WidgetSource,
   WidgetTableSource: () => WidgetTableSource,
   WidgetTilesetSource: () => WidgetTilesetSource,
-  WidgetTilesetWorkerSource: () => WidgetTilesetWorkerSource,
   _buildFeatureFilter: () => _buildFeatureFilter,
   _getHexagonResolution: () => _getHexagonResolution,
   addFilter: () => addFilter,
@@ -2105,6 +2104,15 @@ var _WidgetSource = class _WidgetSource {
     __publicField(this, "props");
     this.props = { ..._WidgetSource.defaultProps, ...props };
   }
+  /**
+   * Destroys the widget source and releases allocated resources.
+   *
+   * For remote sources (tables, queries) this has no effect, but for local
+   * sources (tilesets, rasters) these resources will affect performance
+   * and stability if many (10+) sources are created and not released.
+   */
+  destroy() {
+  }
   _getSpatialFiltersResolution(source, spatialFilter, referenceViewState) {
     if (!spatialFilter || source.spatialDataType === "geo") {
       return;
@@ -2639,6 +2647,9 @@ var WidgetTableSource = class extends WidgetRemoteSource {
 // src/widget-sources/widget-tileset-source.ts
 init_cjs_shims();
 
+// src/widget-sources/widget-tileset-source-impl.ts
+init_cjs_shims();
+
 // src/operations/aggregation.ts
 init_cjs_shims();
 var aggregationFunctions = {
@@ -2987,9 +2998,9 @@ function scatterPlot({
   );
 }
 
-// src/widget-sources/widget-tileset-source.ts
+// src/widget-sources/widget-tileset-source-impl.ts
 var import_boolean_equal = require("@turf/boolean-equal");
-var WidgetTilesetSource = class extends WidgetSource {
+var WidgetTilesetSourceImpl = class extends WidgetSource {
   constructor() {
     super(...arguments);
     __publicField(this, "_tiles", []);
@@ -3274,40 +3285,56 @@ function normalizeColumns(columns) {
   return Array.isArray(columns) ? columns : typeof columns === "string" ? [columns] : [];
 }
 
-// src/widget-sources/widget-tileset-worker-source.ts
-init_cjs_shims();
-var WidgetTilesetWorkerSource = class extends WidgetSource {
+// src/widget-sources/widget-tileset-source.ts
+var WidgetTilesetSource = class extends WidgetSource {
   constructor(props) {
     super(props);
-    /////////////////////////////////////////////////////////////////////////////
-    // WEB WORKER MANAGEMENT
-    __publicField(this, "_worker", null);
+    __publicField(this, "_localImpl", null);
+    __publicField(this, "_workerImpl", null);
+    __publicField(this, "_workerEnabled");
     __publicField(this, "_workerNextRequestId", 1);
+    this._workerEnabled = (props.widgetSourceWorker ?? true) && false;
+    this._localImpl = this._workerEnabled ? null : new WidgetTilesetSourceImpl(this.props);
+  }
+  destroy() {
+    this._localImpl?.destroy();
+    this._localImpl = null;
+    this._workerImpl?.terminate();
+    this._workerImpl = null;
+    super.destroy();
   }
+  /////////////////////////////////////////////////////////////////////////////
+  // WEB WORKER MANAGEMENT
   /**
    * Returns an initialized Worker, to be reused for the lifecycle of this
    * source instance.
    */
   _getWorker() {
-    if (this._worker) {
-      return this._worker;
+    if (this._workerImpl || this._localImpl) {
+      return this._workerImpl;
     }
-    this._worker = new Worker(
-      new URL("@carto/api-client/worker", importMetaUrl),
-      {
+    try {
+      this._workerImpl = new Worker(new URL("worker.js", importMetaUrl), {
         type: "module",
         name: "cartowidgettileset"
-      }
-    );
-    this._worker.postMessage({
-      method: "init" /* INIT */,
-      params: [this.props]
-    });
-    return this._worker;
+      });
+      this._workerImpl.postMessage({
+        method: "init" /* INIT */,
+        params: [this.props]
+      });
+      return this._workerImpl;
+    } catch {
+      this._workerEnabled = false;
+      this._localImpl = new WidgetTilesetSourceImpl(this.props);
+      return null;
+    }
   }
   /** Executes a given method on the worker. */
   _executeWorkerMethod(method, params, signal) {
     const worker = this._getWorker();
+    if (!worker) {
+      return this._localImpl[method](...params);
+    }
     const requestId = this._workerNextRequestId++;
     const options = params[0];
     if (options?.spatialIndexReferenceViewState) {
@@ -3355,19 +3382,27 @@ var WidgetTilesetWorkerSource = class extends WidgetSource {
    * before computing statistics on the tiles.
    */
   loadTiles(tiles2) {
+    const worker = this._getWorker();
+    if (!worker) {
+      return this._localImpl.loadTiles(tiles2);
+    }
     tiles2 = tiles2.map(({ id, bbox, data }) => ({
       id,
       bbox,
       data
     }));
-    this._getWorker().postMessage({
+    worker.postMessage({
       method: "loadTiles" /* LOAD_TILES */,
       params: [tiles2]
     });
   }
   /** Configures options used to extract features from tiles. */
   setTileFeatureExtractOptions(options) {
-    this._getWorker().postMessage({
+    const worker = this._getWorker();
+    if (!worker) {
+      return this._localImpl?.setTileFeatureExtractOptions(options);
+    }
+    worker.postMessage({
       type: "setTileFeatureExtractOptions" /* SET_TILE_FEATURE_EXTRACT_OPTIONS */,
       params: [options]
     });
@@ -3381,7 +3416,11 @@ var WidgetTilesetWorkerSource = class extends WidgetSource {
     geojson,
     spatialFilter
   }) {
-    this._getWorker().postMessage({
+    const worker = this._getWorker();
+    if (!worker) {
+      return this._localImpl.loadGeoJSON({ geojson, spatialFilter });
+    }
+    worker.postMessage({
       method: "loadGeoJSON" /* LOAD_GEOJSON */,
       params: [{ geojson, spatialFilter }]
     });
@@ -3521,36 +3560,14 @@ function getTileFormat(tilejson) {
   return tileParams.get("formatTiles") === "mvt" ? "mvt" /* MVT */ : "binary" /* BINARY */;
 }
 
-// src/workers/utils.ts
-init_cjs_shims();
-var _isModuleWorkerSupported = true ? false : null;
-function isModuleWorkerSupported() {
-  if (_isModuleWorkerSupported !== null) {
-    return _isModuleWorkerSupported;
-  }
-  try {
-    new Worker("blob://", {
-      get type() {
-        _isModuleWorkerSupported = true;
-        return "module";
-      }
-    });
-  } catch {
-  } finally {
-    _isModuleWorkerSupported || (_isModuleWorkerSupported = false);
-  }
-  return _isModuleWorkerSupported;
-}
-
 // src/sources/h3-tileset-source.ts
 var h3TilesetSource = async function(options) {
   const { tableName, spatialDataColumn = "h3" } = options;
   const urlParameters = { name: tableName };
-  const WidgetSourceClass = options.widgetSourceWorker !== false && isModuleWorkerSupported() ? WidgetTilesetWorkerSource : WidgetTilesetSource;
   return baseSource("tileset", options, urlParameters).then(
     (result) => ({
       ...result,
-      widgetSource: new WidgetSourceClass({
+      widgetSource: new WidgetTilesetSource({
         ...options,
         tileFormat: getTileFormat(result),
         spatialDataColumn,
@@ -3656,11 +3673,10 @@ init_cjs_shims();
 var quadbinTilesetSource = async function(options) {
   const { tableName, spatialDataColumn = "quadbin" } = options;
   const urlParameters = { name: tableName };
-  const WidgetSourceClass = options.widgetSourceWorker !== false && isModuleWorkerSupported() ? WidgetTilesetWorkerSource : WidgetTilesetSource;
   return baseSource("tileset", options, urlParameters).then(
     (result) => ({
       ...result,
-      widgetSource: new WidgetSourceClass({
+      widgetSource: new WidgetTilesetSource({
         ...options,
         tileFormat: getTileFormat(result),
         spatialDataColumn,
@@ -3761,11 +3777,10 @@ init_cjs_shims();
 var vectorTilesetSource = async function(options) {
   const { tableName, spatialDataColumn = DEFAULT_GEO_COLUMN } = options;
   const urlParameters = { name: tableName };
-  const WidgetSourceClass = options.widgetSourceWorker !== false && isModuleWorkerSupported() ? WidgetTilesetWorkerSource : WidgetTilesetSource;
   return baseSource("tileset", options, urlParameters).then(
     (result) => ({
       ...result,
-      widgetSource: new WidgetSourceClass({
+      widgetSource: new WidgetTilesetSource({
         ...options,
         tileFormat: getTileFormat(result),
         spatialDataColumn,
@@ -3831,7 +3846,6 @@ var query = async function(options) {
   WidgetSource,
   WidgetTableSource,
   WidgetTilesetSource,
-  WidgetTilesetWorkerSource,
   _buildFeatureFilter,
   _getHexagonResolution,
   addFilter,

package/build/api-client.d.cts

@@ -863,6 +863,14 @@ declare abstract class WidgetSource<Props extends WidgetSourceProps> {
     readonly props: Props;
     static defaultProps: Partial<WidgetSourceProps>;
     constructor(props: Props);
+    /**
+     * Destroys the widget source and releases allocated resources.
+     *
+     * For remote sources (tables, queries) this has no effect, but for local
+     * sources (tilesets, rasters) these resources will affect performance
+     * and stability if many (10+) sources are created and not released.
+     */
+    destroy(): void;
     protected _getSpatialFiltersResolution(source: Omit<ModelSource, 'type' | 'data'>, spatialFilter?: SpatialFilter, referenceViewState?: ViewState): number | undefined;
     /**
      * Returns a list of labeled datapoints for categorical data. Suitable for
@@ -1066,36 +1074,26 @@ type TileFeaturesSpatialIndexOptions = {
 };
 declare function tileFeaturesSpatialIndex({ tiles, spatialFilter, spatialDataColumn, spatialDataType, }: TileFeaturesSpatialIndexOptions): FeatureData[];
 
-type WidgetTilesetSourceProps = WidgetSourceProps & Omit<TilesetSourceOptions, 'filters'> & {
-    tileFormat: TileFormat;
-    spatialDataType: SpatialDataType;
-};
-type WidgetTilesetSourceResult = {
-    widgetSource: WidgetTilesetSource;
-};
+declare enum Method {
+    INIT = "init",
+    LOAD_TILES = "loadTiles",
+    SET_TILE_FEATURE_EXTRACT_OPTIONS = "setTileFeatureExtractOptions",
+    LOAD_GEOJSON = "loadGeoJSON",
+    GET_FORMULA = "getFormula",
+    GET_HISTOGRAM = "getHistogram",
+    GET_CATEGORIES = "getCategories",
+    GET_SCATTER = "getScatter",
+    GET_TABLE = "getTable",
+    GET_TIME_SERIES = "getTimeSeries",
+    GET_RANGE = "getRange"
+}
+
 /**
- * Source for Widget API requests on a data source defined by a tileset.
- *
- * Generally not intended to be constructed directly. Instead, call
- * {@link vectorTilesetSource}, {@link h3TilesetSource}, or {@link quadbinTilesetSource},
- * which can be shared with map layers. Sources contain a `widgetSource`
- * property, for use by widget implementations.
- *
- * Example:
- *
- * ```javascript
- * import { vectorTilesetSource } from '@carto/api-client';
- *
- * const data = vectorTilesetSource({
- *   accessToken: '••••',
- *   connectionName: 'carto_dw',
- *   tableName: 'carto-demo-data.demo_rasters.my_tileset_source'
- * });
- *
- * const { widgetSource } = await data;
- * ```
+ * Local (in-memory) implementation of tileset widget calculations. This class
+ * may be instantiated by {@link WidgetTilesetSource} in a Web Worker when
+ * supported, or on the main thread.
  */
-declare class WidgetTilesetSource extends WidgetSource<WidgetTilesetSourceProps> {
+declare class WidgetTilesetSourceImpl extends WidgetSource<WidgetTilesetSourceProps> {
     private _tiles;
     private _features;
     private _tileFeatureExtractOptions;
@@ -1132,40 +1130,49 @@ declare class WidgetTilesetSource extends WidgetSource<WidgetTilesetSourceProps>
     private _getFilteredFeatures;
 }
 
-declare enum Method {
-    INIT = "init",
-    LOAD_TILES = "loadTiles",
-    SET_TILE_FEATURE_EXTRACT_OPTIONS = "setTileFeatureExtractOptions",
-    LOAD_GEOJSON = "loadGeoJSON",
-    GET_FORMULA = "getFormula",
-    GET_HISTOGRAM = "getHistogram",
-    GET_CATEGORIES = "getCategories",
-    GET_SCATTER = "getScatter",
-    GET_TABLE = "getTable",
-    GET_TIME_SERIES = "getTimeSeries",
-    GET_RANGE = "getRange"
-}
-
+type WidgetTilesetSourceProps = WidgetSourceProps & Omit<TilesetSourceOptions, 'filters'> & {
+    tileFormat: TileFormat;
+    spatialDataType: SpatialDataType;
+};
+type WidgetTilesetSourceResult = {
+    widgetSource: WidgetTilesetSource;
+};
 /**
- * Wrapper for {@link WidgetTilesetSource}, moving calculations to Web Workers.
- * When supported, use of both classes is identical.
+ * Source for Widget API requests on a data source defined by a tileset.
+ *
+ * Generally not intended to be constructed directly. Instead, call
+ * {@link vectorTilesetSource}, {@link h3TilesetSource}, or {@link quadbinTilesetSource},
+ * which can be shared with map layers. Sources contain a `widgetSource`
+ * property, for use by widget implementations.
+ *
+ * Example:
+ *
+ * ```javascript
+ * import { vectorTilesetSource } from '@carto/api-client';
  *
- * To use this wrapper, the application and environment must support ESM Web
- * Workers. For older build systems based on CommonJS, or in environments like
- * Node.js, it may be necessary to use {@link WidgetTilesetSource} directly,
- * and to (optionally) create workers manually in the application.
+ * const data = vectorTilesetSource({
+ *   accessToken: '••••',
+ *   connectionName: 'carto_dw',
+ *   tableName: 'carto-demo-data.demo_rasters.my_tileset_source'
+ * });
+ *
+ * const { widgetSource } = await data;
+ * ```
  */
-declare class WidgetTilesetWorkerSource extends WidgetSource<WidgetTilesetSourceProps> {
-    constructor(props: WidgetTilesetSourceProps);
-    protected _worker: Worker | null;
+declare class WidgetTilesetSource extends WidgetSource<WidgetTilesetSourceProps> {
+    protected _localImpl: WidgetTilesetSourceImpl | null;
+    protected _workerImpl: Worker | null;
+    protected _workerEnabled: boolean;
     protected _workerNextRequestId: number;
+    constructor(props: WidgetTilesetSourceProps);
+    destroy(): void;
     /**
      * Returns an initialized Worker, to be reused for the lifecycle of this
      * source instance.
      */
-    _getWorker(): Worker;
+    protected _getWorker(): Worker | null;
     /** Executes a given method on the worker. */
-    _executeWorkerMethod<T>(method: Method, params: unknown[], signal?: AbortSignal): Promise<T>;
+    protected _executeWorkerMethod<T>(method: Method, params: unknown[], signal?: AbortSignal): Promise<T>;
     /**
      * Loads features as a list of tiles (typically provided by deck.gl).
      * After tiles are loaded, {@link extractTileFeatures} must be called
@@ -1381,4 +1388,4 @@ declare function makeIntervalComplete(intervals: FilterInterval[]): FilterInterv
  */
 declare function transformToTileCoords<T extends Geometry>(geometry: T, bbox: BBox): T;
 
-export { type APIErrorContext, type APIRequestType, type AddFilterOptions, type AggregationFunction, type AggregationType, ApiVersion, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CartoAPIError, type CategoryRequestOptions, type CategoryResponse, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, type FeaturesRequestOptions, type FeaturesResponse, type Filter, type FilterFunction, type FilterInterval, type FilterIntervalComplete, type FilterIntervalExtremum, type FilterLogicalOperator, FilterType, type Filters, type Format, type FormulaRequestOptions, type FormulaResponse, type GeojsonResult, type GetFilterOptions, type GroupByFeature, type GroupDateType, type H3QuerySourceOptions, type H3QuerySourceResponse, type H3TableSourceOptions, type H3TableSourceResponse, type H3TilesetSourceOptions, type H3TilesetSourceResponse, type HasFilterOptions, type HistogramRequestOptions, type HistogramResponse, type JsonResult, type MapType, type NamedQueryParameter, type PositionalQueryParameter, Provider, type QuadbinQuerySourceOptions, type QuadbinQuerySourceResponse, type QuadbinTableSourceOptions, type QuadbinTableSourceResponse, type QuadbinTilesetSourceOptions, type QuadbinTilesetSourceResponse, type QueryOptions, type QueryParameterValue, type QueryParameters, type QueryResult, type QuerySourceOptions, type RangeRequestOptions, type RangeResponse, type Raster, RasterBandColorinterp, type RasterMetadata, type RasterMetadataBand, type RasterMetadataBandStats, type RasterSourceOptions, type RemoveFilterOptions, SOURCE_DEFAULTS, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SortColumnType, type SortDirection, type SourceOptions, type SpatialFilter, type SpatialFilterPolyfillMode, SpatialIndex, type SpatialIndexTile, type StringSearchOptions, type TableRequestOptions, type TableResponse, type TableSourceOptions, type Tile, type TileFeatureExtractOptions, type TileFeatures, type TileFeaturesSpatialIndexOptions, TileFormat, type TileResolution, type TilejsonResult, type TilesetSourceOptions, type TimeSeriesRequestOptions, type TimeSeriesResponse, type VectorLayer, type VectorQuerySourceOptions, type VectorQuerySourceResponse, type VectorTableSourceOptions, type VectorTableSourceResponse, type VectorTilesetSourceOptions, type VectorTilesetSourceResponse, type ViewState, type Viewport, WidgetQuerySource, type WidgetQuerySourceResult, WidgetRemoteSource, type WidgetRemoteSourceProps, WidgetSource, type WidgetSourceProps, WidgetTableSource, type WidgetTableSourceResult, WidgetTilesetSource, type WidgetTilesetSourceProps, type WidgetTilesetSourceResult, WidgetTilesetWorkerSource, type _DataFilterExtensionProps, _buildFeatureFilter, _getHexagonResolution, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, clearFilters, createPolygonSpatialFilter, createViewportSpatialFilter, filterFunctions, geojsonFeatures, getClient, getDataFilterExtensionProps, getFilter, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };
+export { type APIErrorContext, type APIRequestType, type AddFilterOptions, type AggregationFunction, type AggregationType, ApiVersion, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CartoAPIError, type CategoryRequestOptions, type CategoryResponse, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, type FeaturesRequestOptions, type FeaturesResponse, type Filter, type FilterFunction, type FilterInterval, type FilterIntervalComplete, type FilterIntervalExtremum, type FilterLogicalOperator, FilterType, type Filters, type Format, type FormulaRequestOptions, type FormulaResponse, type GeojsonResult, type GetFilterOptions, type GroupByFeature, type GroupDateType, type H3QuerySourceOptions, type H3QuerySourceResponse, type H3TableSourceOptions, type H3TableSourceResponse, type H3TilesetSourceOptions, type H3TilesetSourceResponse, type HasFilterOptions, type HistogramRequestOptions, type HistogramResponse, type JsonResult, type MapType, type NamedQueryParameter, type PositionalQueryParameter, Provider, type QuadbinQuerySourceOptions, type QuadbinQuerySourceResponse, type QuadbinTableSourceOptions, type QuadbinTableSourceResponse, type QuadbinTilesetSourceOptions, type QuadbinTilesetSourceResponse, type QueryOptions, type QueryParameterValue, type QueryParameters, type QueryResult, type QuerySourceOptions, type RangeRequestOptions, type RangeResponse, type Raster, RasterBandColorinterp, type RasterMetadata, type RasterMetadataBand, type RasterMetadataBandStats, type RasterSourceOptions, type RemoveFilterOptions, SOURCE_DEFAULTS, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SortColumnType, type SortDirection, type SourceOptions, type SpatialFilter, type SpatialFilterPolyfillMode, SpatialIndex, type SpatialIndexTile, type StringSearchOptions, type TableRequestOptions, type TableResponse, type TableSourceOptions, type Tile, type TileFeatureExtractOptions, type TileFeatures, type TileFeaturesSpatialIndexOptions, TileFormat, type TileResolution, type TilejsonResult, type TilesetSourceOptions, type TimeSeriesRequestOptions, type TimeSeriesResponse, type VectorLayer, type VectorQuerySourceOptions, type VectorQuerySourceResponse, type VectorTableSourceOptions, type VectorTableSourceResponse, type VectorTilesetSourceOptions, type VectorTilesetSourceResponse, type ViewState, type Viewport, WidgetQuerySource, type WidgetQuerySourceResult, WidgetRemoteSource, type WidgetRemoteSourceProps, WidgetSource, type WidgetSourceProps, WidgetTableSource, type WidgetTableSourceResult, WidgetTilesetSource, type WidgetTilesetSourceProps, type WidgetTilesetSourceResult, type _DataFilterExtensionProps, _buildFeatureFilter, _getHexagonResolution, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, clearFilters, createPolygonSpatialFilter, createViewportSpatialFilter, filterFunctions, geojsonFeatures, getClient, getDataFilterExtensionProps, getFilter, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };

package/build/api-client.d.ts

@@ -863,6 +863,14 @@ declare abstract class WidgetSource<Props extends WidgetSourceProps> {
     readonly props: Props;
     static defaultProps: Partial<WidgetSourceProps>;
     constructor(props: Props);
+    /**
+     * Destroys the widget source and releases allocated resources.
+     *
+     * For remote sources (tables, queries) this has no effect, but for local
+     * sources (tilesets, rasters) these resources will affect performance
+     * and stability if many (10+) sources are created and not released.
+     */
+    destroy(): void;
     protected _getSpatialFiltersResolution(source: Omit<ModelSource, 'type' | 'data'>, spatialFilter?: SpatialFilter, referenceViewState?: ViewState): number | undefined;
     /**
      * Returns a list of labeled datapoints for categorical data. Suitable for
@@ -1066,36 +1074,26 @@ type TileFeaturesSpatialIndexOptions = {
 };
 declare function tileFeaturesSpatialIndex({ tiles, spatialFilter, spatialDataColumn, spatialDataType, }: TileFeaturesSpatialIndexOptions): FeatureData[];
 
-type WidgetTilesetSourceProps = WidgetSourceProps & Omit<TilesetSourceOptions, 'filters'> & {
-    tileFormat: TileFormat;
-    spatialDataType: SpatialDataType;
-};
-type WidgetTilesetSourceResult = {
-    widgetSource: WidgetTilesetSource;
-};
+declare enum Method {
+    INIT = "init",
+    LOAD_TILES = "loadTiles",
+    SET_TILE_FEATURE_EXTRACT_OPTIONS = "setTileFeatureExtractOptions",
+    LOAD_GEOJSON = "loadGeoJSON",
+    GET_FORMULA = "getFormula",
+    GET_HISTOGRAM = "getHistogram",
+    GET_CATEGORIES = "getCategories",
+    GET_SCATTER = "getScatter",
+    GET_TABLE = "getTable",
+    GET_TIME_SERIES = "getTimeSeries",
+    GET_RANGE = "getRange"
+}
+
 /**
- * Source for Widget API requests on a data source defined by a tileset.
- *
- * Generally not intended to be constructed directly. Instead, call
- * {@link vectorTilesetSource}, {@link h3TilesetSource}, or {@link quadbinTilesetSource},
- * which can be shared with map layers. Sources contain a `widgetSource`
- * property, for use by widget implementations.
- *
- * Example:
- *
- * ```javascript
- * import { vectorTilesetSource } from '@carto/api-client';
- *
- * const data = vectorTilesetSource({
- *   accessToken: '••••',
- *   connectionName: 'carto_dw',
- *   tableName: 'carto-demo-data.demo_rasters.my_tileset_source'
- * });
- *
- * const { widgetSource } = await data;
- * ```
+ * Local (in-memory) implementation of tileset widget calculations. This class
+ * may be instantiated by {@link WidgetTilesetSource} in a Web Worker when
+ * supported, or on the main thread.
  */
-declare class WidgetTilesetSource extends WidgetSource<WidgetTilesetSourceProps> {
+declare class WidgetTilesetSourceImpl extends WidgetSource<WidgetTilesetSourceProps> {
     private _tiles;
     private _features;
     private _tileFeatureExtractOptions;
@@ -1132,40 +1130,49 @@ declare class WidgetTilesetSource extends WidgetSource<WidgetTilesetSourceProps>
     private _getFilteredFeatures;
 }
 
-declare enum Method {
-    INIT = "init",
-    LOAD_TILES = "loadTiles",
-    SET_TILE_FEATURE_EXTRACT_OPTIONS = "setTileFeatureExtractOptions",
-    LOAD_GEOJSON = "loadGeoJSON",
-    GET_FORMULA = "getFormula",
-    GET_HISTOGRAM = "getHistogram",
-    GET_CATEGORIES = "getCategories",
-    GET_SCATTER = "getScatter",
-    GET_TABLE = "getTable",
-    GET_TIME_SERIES = "getTimeSeries",
-    GET_RANGE = "getRange"
-}
-
+type WidgetTilesetSourceProps = WidgetSourceProps & Omit<TilesetSourceOptions, 'filters'> & {
+    tileFormat: TileFormat;
+    spatialDataType: SpatialDataType;
+};
+type WidgetTilesetSourceResult = {
+    widgetSource: WidgetTilesetSource;
+};
 /**
- * Wrapper for {@link WidgetTilesetSource}, moving calculations to Web Workers.
- * When supported, use of both classes is identical.
+ * Source for Widget API requests on a data source defined by a tileset.
+ *
+ * Generally not intended to be constructed directly. Instead, call
+ * {@link vectorTilesetSource}, {@link h3TilesetSource}, or {@link quadbinTilesetSource},
+ * which can be shared with map layers. Sources contain a `widgetSource`
+ * property, for use by widget implementations.
+ *
+ * Example:
+ *
+ * ```javascript
+ * import { vectorTilesetSource } from '@carto/api-client';
  *
- * To use this wrapper, the application and environment must support ESM Web
- * Workers. For older build systems based on CommonJS, or in environments like
- * Node.js, it may be necessary to use {@link WidgetTilesetSource} directly,
- * and to (optionally) create workers manually in the application.
+ * const data = vectorTilesetSource({
+ *   accessToken: '••••',
+ *   connectionName: 'carto_dw',
+ *   tableName: 'carto-demo-data.demo_rasters.my_tileset_source'
+ * });
+ *
+ * const { widgetSource } = await data;
+ * ```
  */
-declare class WidgetTilesetWorkerSource extends WidgetSource<WidgetTilesetSourceProps> {
-    constructor(props: WidgetTilesetSourceProps);
-    protected _worker: Worker | null;
+declare class WidgetTilesetSource extends WidgetSource<WidgetTilesetSourceProps> {
+    protected _localImpl: WidgetTilesetSourceImpl | null;
+    protected _workerImpl: Worker | null;
+    protected _workerEnabled: boolean;
     protected _workerNextRequestId: number;
+    constructor(props: WidgetTilesetSourceProps);
+    destroy(): void;
     /**
      * Returns an initialized Worker, to be reused for the lifecycle of this
      * source instance.
      */
-    _getWorker(): Worker;
+    protected _getWorker(): Worker | null;
     /** Executes a given method on the worker. */
-    _executeWorkerMethod<T>(method: Method, params: unknown[], signal?: AbortSignal): Promise<T>;
+    protected _executeWorkerMethod<T>(method: Method, params: unknown[], signal?: AbortSignal): Promise<T>;
     /**
      * Loads features as a list of tiles (typically provided by deck.gl).
      * After tiles are loaded, {@link extractTileFeatures} must be called
@@ -1381,4 +1388,4 @@ declare function makeIntervalComplete(intervals: FilterInterval[]): FilterInterv
  */
 declare function transformToTileCoords<T extends Geometry>(geometry: T, bbox: BBox): T;
 
-export { type APIErrorContext, type APIRequestType, type AddFilterOptions, type AggregationFunction, type AggregationType, ApiVersion, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CartoAPIError, type CategoryRequestOptions, type CategoryResponse, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, type FeaturesRequestOptions, type FeaturesResponse, type Filter, type FilterFunction, type FilterInterval, type FilterIntervalComplete, type FilterIntervalExtremum, type FilterLogicalOperator, FilterType, type Filters, type Format, type FormulaRequestOptions, type FormulaResponse, type GeojsonResult, type GetFilterOptions, type GroupByFeature, type GroupDateType, type H3QuerySourceOptions, type H3QuerySourceResponse, type H3TableSourceOptions, type H3TableSourceResponse, type H3TilesetSourceOptions, type H3TilesetSourceResponse, type HasFilterOptions, type HistogramRequestOptions, type HistogramResponse, type JsonResult, type MapType, type NamedQueryParameter, type PositionalQueryParameter, Provider, type QuadbinQuerySourceOptions, type QuadbinQuerySourceResponse, type QuadbinTableSourceOptions, type QuadbinTableSourceResponse, type QuadbinTilesetSourceOptions, type QuadbinTilesetSourceResponse, type QueryOptions, type QueryParameterValue, type QueryParameters, type QueryResult, type QuerySourceOptions, type RangeRequestOptions, type RangeResponse, type Raster, RasterBandColorinterp, type RasterMetadata, type RasterMetadataBand, type RasterMetadataBandStats, type RasterSourceOptions, type RemoveFilterOptions, SOURCE_DEFAULTS, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SortColumnType, type SortDirection, type SourceOptions, type SpatialFilter, type SpatialFilterPolyfillMode, SpatialIndex, type SpatialIndexTile, type StringSearchOptions, type TableRequestOptions, type TableResponse, type TableSourceOptions, type Tile, type TileFeatureExtractOptions, type TileFeatures, type TileFeaturesSpatialIndexOptions, TileFormat, type TileResolution, type TilejsonResult, type TilesetSourceOptions, type TimeSeriesRequestOptions, type TimeSeriesResponse, type VectorLayer, type VectorQuerySourceOptions, type VectorQuerySourceResponse, type VectorTableSourceOptions, type VectorTableSourceResponse, type VectorTilesetSourceOptions, type VectorTilesetSourceResponse, type ViewState, type Viewport, WidgetQuerySource, type WidgetQuerySourceResult, WidgetRemoteSource, type WidgetRemoteSourceProps, WidgetSource, type WidgetSourceProps, WidgetTableSource, type WidgetTableSourceResult, WidgetTilesetSource, type WidgetTilesetSourceProps, type WidgetTilesetSourceResult, WidgetTilesetWorkerSource, type _DataFilterExtensionProps, _buildFeatureFilter, _getHexagonResolution, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, clearFilters, createPolygonSpatialFilter, createViewportSpatialFilter, filterFunctions, geojsonFeatures, getClient, getDataFilterExtensionProps, getFilter, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };
+export { type APIErrorContext, type APIRequestType, type AddFilterOptions, type AggregationFunction, type AggregationType, ApiVersion, type BoundaryQuerySourceOptions, type BoundaryQuerySourceResponse, type BoundaryTableSourceOptions, type BoundaryTableSourceResponse, CartoAPIError, type CategoryRequestOptions, type CategoryResponse, DEFAULT_API_BASE_URL, FEATURE_GEOM_PROPERTY, type FeaturesRequestOptions, type FeaturesResponse, type Filter, type FilterFunction, type FilterInterval, type FilterIntervalComplete, type FilterIntervalExtremum, type FilterLogicalOperator, FilterType, type Filters, type Format, type FormulaRequestOptions, type FormulaResponse, type GeojsonResult, type GetFilterOptions, type GroupByFeature, type GroupDateType, type H3QuerySourceOptions, type H3QuerySourceResponse, type H3TableSourceOptions, type H3TableSourceResponse, type H3TilesetSourceOptions, type H3TilesetSourceResponse, type HasFilterOptions, type HistogramRequestOptions, type HistogramResponse, type JsonResult, type MapType, type NamedQueryParameter, type PositionalQueryParameter, Provider, type QuadbinQuerySourceOptions, type QuadbinQuerySourceResponse, type QuadbinTableSourceOptions, type QuadbinTableSourceResponse, type QuadbinTilesetSourceOptions, type QuadbinTilesetSourceResponse, type QueryOptions, type QueryParameterValue, type QueryParameters, type QueryResult, type QuerySourceOptions, type RangeRequestOptions, type RangeResponse, type Raster, RasterBandColorinterp, type RasterMetadata, type RasterMetadataBand, type RasterMetadataBandStats, type RasterSourceOptions, type RemoveFilterOptions, SOURCE_DEFAULTS, type ScatterPlotFeature, type ScatterRequestOptions, type ScatterResponse, type SortColumnType, type SortDirection, type SourceOptions, type SpatialFilter, type SpatialFilterPolyfillMode, SpatialIndex, type SpatialIndexTile, type StringSearchOptions, type TableRequestOptions, type TableResponse, type TableSourceOptions, type Tile, type TileFeatureExtractOptions, type TileFeatures, type TileFeaturesSpatialIndexOptions, TileFormat, type TileResolution, type TilejsonResult, type TilesetSourceOptions, type TimeSeriesRequestOptions, type TimeSeriesResponse, type VectorLayer, type VectorQuerySourceOptions, type VectorQuerySourceResponse, type VectorTableSourceOptions, type VectorTableSourceResponse, type VectorTilesetSourceOptions, type VectorTilesetSourceResponse, type ViewState, type Viewport, WidgetQuerySource, type WidgetQuerySourceResult, WidgetRemoteSource, type WidgetRemoteSourceProps, WidgetSource, type WidgetSourceProps, WidgetTableSource, type WidgetTableSourceResult, WidgetTilesetSource, type WidgetTilesetSourceProps, type WidgetTilesetSourceResult, type _DataFilterExtensionProps, _buildFeatureFilter, _getHexagonResolution, addFilter, aggregate, aggregationFunctions, applyFilters, applySorting, boundaryQuerySource, boundaryTableSource, buildBinaryFeatureFilter, buildPublicMapUrl, buildStatsUrl, clearFilters, createPolygonSpatialFilter, createViewportSpatialFilter, filterFunctions, geojsonFeatures, getClient, getDataFilterExtensionProps, getFilter, groupValuesByColumn, groupValuesByDateColumn, h3QuerySource, h3TableSource, h3TilesetSource, hasFilter, histogram, makeIntervalComplete, quadbinQuerySource, quadbinTableSource, quadbinTilesetSource, query, rasterSource, removeFilter, requestWithParameters, scatterPlot, setClient, tileFeatures, tileFeaturesGeometries, tileFeaturesSpatialIndex, transformToTileCoords, vectorQuerySource, vectorTableSource, vectorTilesetSource };