@loaders.gl/loader-utils 4.3.0-alpha.1 → 4.3.0-alpha.3

package/dist/lib/sources/vector-source.d.ts

@@ -0,0 +1,61 @@
+import type { Schema, GeoJSONTable, BinaryFeatureCollection } from '@loaders.gl/schema';
+import type { DataSourceProps } from "./data-source.js";
+import { DataSource } from "./data-source.js";
+export type VectorSourceProps = DataSourceProps;
+/**
+ * VectorSource - data sources that allow features to be queried by (geospatial) extents
+ * @note
+ * - If geospatial, bounding box is expected to be in web mercator coordinates
+ */
+export declare abstract class VectorSource<PropsT extends VectorSourceProps = VectorSourceProps> extends DataSource<PropsT> {
+    static type: string;
+    static testURL: (url: string) => boolean;
+    abstract getSchema(): Promise<Schema>;
+    abstract getMetadata(options: {
+        formatSpecificMetadata?: boolean;
+    }): Promise<VectorSourceMetadata>;
+    abstract getFeatures(parameters: GetFeaturesParameters): Promise<GeoJSONTable | BinaryFeatureCollection>;
+}
+/**
+ * Normalized capabilities of an Image service
+ * @example
+ *  The WMSSourceLoader will normalize the response to the WMS `GetCapabilities`
+ *  data structure extracted from WMS XML response into an VectorSourceMetadata.
+ */
+export type VectorSourceMetadata = {
+    name: string;
+    title?: string;
+    abstract?: string;
+    keywords: string[];
+    layers: VectorSourceLayer[];
+    /**
+     * Attempts to preserve the original format specific metadata from the underlying source,
+     * May be an approximate representation
+     */
+    formatSpecificMetadata?: Record<string, any>;
+};
+/** Description of one data layer in the image source */
+export type VectorSourceLayer = {
+    /** Name of this layer */
+    name?: string;
+    /** Human readable title of this layer */
+    title?: string;
+    /** Coordinate systems supported by this layer */
+    crs?: string[];
+    /** layer limits in unspecified CRS:84-like lng/lat, for quick access w/o CRS calculations. */
+    boundingBox?: [min: [x: number, y: number], max: [x: number, y: number]];
+    /** Sub layers of this layer */
+    layers?: VectorSourceLayer[];
+};
+/** Generic parameters for requesting an image from an image source */
+export type GetFeaturesParameters = {
+    /** Layers to render */
+    layers: string | string[];
+    /** bounding box on the map (only return features within this bbox) */
+    boundingBox: [min: [x: number, y: number], max: [x: number, y: number]];
+    /** crs for the returned features (not the bounding box) */
+    crs?: string;
+    /** @deprecated requested format for the return image */
+    format?: 'geojson' | 'binary';
+};
+//# sourceMappingURL=vector-source.d.ts.map

package/dist/lib/sources/vector-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vector-source.d.ts","sourceRoot":"","sources":["../../../src/lib/sources/vector-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAE,YAAY,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AACtF,OAAO,KAAK,EAAC,eAAe,EAAC,yBAAsB;AACnD,OAAO,EAAC,UAAU,EAAC,yBAAsB;AAEzC,MAAM,MAAM,iBAAiB,GAAG,eAAe,CAAC;AAEhD;;;;GAIG;AACH,8BAAsB,YAAY,CAChC,MAAM,SAAS,iBAAiB,GAAG,iBAAiB,CACpD,SAAQ,UAAU,CAAC,MAAM,CAAC;IAC1B,MAAM,CAAC,IAAI,EAAE,MAAM,CAAc;IACjC,MAAM,CAAC,OAAO,QAAS,MAAM,KAAG,OAAO,CAAU;IAEjD,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IACrC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE;QAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAChG,QAAQ,CAAC,WAAW,CAClB,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,YAAY,GAAG,uBAAuB,CAAC;CACnD;AAID;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9C,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,yBAAyB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,8FAA8F;IAC9F,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACzE,+BAA+B;IAC/B,MAAM,CAAC,EAAE,iBAAiB,EAAE,CAAC;CAC9B,CAAC;AAEF,sEAAsE;AACtE,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB;IACvB,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B,sEAAsE;IACtE,WAAW,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;IACxE,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC/B,CAAC"}

package/dist/lib/sources/vector-source.js

@@ -0,0 +1,13 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { DataSource } from "./data-source.js";
+/**
+ * VectorSource - data sources that allow features to be queried by (geospatial) extents
+ * @note
+ * - If geospatial, bounding box is expected to be in web mercator coordinates
+ */
+export class VectorSource extends DataSource {
+    static type = 'template';
+    static testURL = (url) => false;
+}

package/dist/lib/sources/vector-tile-source.d.ts

@@ -1,12 +1,15 @@
-import { TileSource, TileSourceProps, TileSourceMetadata } from "./tile-source.js";
-import type { GetTileParameters } from "./tile-source.js";
+import type { Schema, Feature, BinaryFeatureCollection } from '@loaders.gl/schema';
+import { TileSource, TileSourceProps, TileSourceMetadata, GetTileParameters } from "./tile-source.js";
+import type { GetTileDataParameters } from "./tile-source.js";
 export type VectorTile = unknown;
 export type VectorTileSourceProps = TileSourceProps;
 /**
  * VectorTileSource - data sources that allow data to be queried by (geospatial) tile
  * @note If geospatial, bounding box is expected to be in web mercator coordinates
  */
-export interface VectorTileSource<MetadataT extends TileSourceMetadata = TileSourceMetadata> extends TileSource<MetadataT> {
+export interface VectorTileSource<PropsT extends VectorTileSourceProps = VectorTileSourceProps, MetadataT extends TileSourceMetadata = TileSourceMetadata> extends TileSource<PropsT, MetadataT> {
+    getSchema(): Promise<Schema>;
     getVectorTile(parameters: GetTileParameters): Promise<VectorTile | null>;
+    getTileData(parameters: GetTileDataParameters): Promise<Feature[] | BinaryFeatureCollection | null>;
 }
 //# sourceMappingURL=vector-tile-source.d.ts.map

package/dist/lib/sources/vector-tile-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vector-tile-source.d.ts","sourceRoot":"","sources":["../../../src/lib/sources/vector-tile-source.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,UAAU,EAAE,eAAe,EAAE,kBAAkB,EAAC,yBAAsB;AAC9E,OAAO,KAAK,EAAC,iBAAiB,EAAC,yBAAsB;AAErD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,SAAS,SAAS,kBAAkB,GAAG,kBAAkB,CACzF,SAAQ,UAAU,CAAC,SAAS,CAAC;IAC7B,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CAC1E"}
+{"version":3,"file":"vector-tile-source.d.ts","sourceRoot":"","sources":["../../../src/lib/sources/vector-tile-source.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAE,OAAO,EAAE,uBAAuB,EAAC,MAAM,oBAAoB,CAAC;AACjF,OAAO,EAAC,UAAU,EAAE,eAAe,EAAE,kBAAkB,EAAE,iBAAiB,EAAC,yBAAsB;AACjG,OAAO,KAAK,EAAC,qBAAqB,EAAC,yBAAsB;AAEzD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AAEjC,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAC/B,MAAM,SAAS,qBAAqB,GAAG,qBAAqB,EAC5D,SAAS,SAAS,kBAAkB,GAAG,kBAAkB,CACzD,SAAQ,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC;IACrC,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,aAAa,CAAC,UAAU,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACzE,WAAW,CACT,UAAU,EAAE,qBAAqB,GAChC,OAAO,CAAC,OAAO,EAAE,GAAG,uBAAuB,GAAG,IAAI,CAAC,CAAC;CACxD"}

package/dist/source-types.d.ts

@@ -0,0 +1,39 @@
+import type { DataSource, DataSourceProps } from "./lib/sources/data-source.js";
+/**
+ * A `Source` contains metadata and a factory method for creating instances of a specific `DataSource`.
+ * It allows a list of `Source` objects to be passed to methods
+ * @example
+ *  `createDataSource(... , [MVTSource, PMTilesSource, ...])
+ */
+export interface Source<DataSourceT extends DataSource = DataSource, DataSourcePropsT extends DataSourceProps = any> {
+    /** Type of source created by this service */
+    source?: DataSourceT;
+    /** Type of props used when creating sources */
+    props?: DataSourcePropsT;
+    /** Name of the service */
+    name: string;
+    id: string;
+    /** Module containing the service */
+    module: string;
+    /** Version of the loaders.gl package containing this service. */
+    version: string;
+    /** URL extensions that this service uses */
+    extensions: string[];
+    /** MIME extensions that this service uses */
+    mimeTypes: string[];
+    /** Default options */
+    options: DataSourcePropsT;
+    /** Type string identifying this service, e.g. 'wms' */
+    type: string;
+    /** Can source be created from a URL */
+    fromUrl: boolean;
+    /** Can source be created from a Blob or File */
+    fromBlob: boolean;
+    /** Check if a URL can support this service */
+    testURL: (url: string) => boolean;
+    /** Test data */
+    testData?: (data: Blob) => boolean;
+    /** Create a source  */
+    createDataSource(data: string | Blob, props: DataSourcePropsT): DataSourceT;
+}
+//# sourceMappingURL=source-types.d.ts.map

package/dist/source-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-types.d.ts","sourceRoot":"","sources":["../src/source-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAE,eAAe,EAAC,qCAAkC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,MAAM,CACrB,WAAW,SAAS,UAAU,GAAG,UAAU,EAC3C,gBAAgB,SAAS,eAAe,GAAG,GAAG;IAE9C,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAEzB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,sBAAsB;IACtB,OAAO,EAAE,gBAAgB,CAAC;IAE1B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAC;IAElB,8CAA8C;IAC9C,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,gBAAgB;IAChB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IACnC,uBAAuB;IACvB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAAC;CAC7E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/loader-utils",
-  "version": "4.3.0-alpha.1",
+  "version": "4.3.0-alpha.3",
   "description": "Framework-independent loaders for 3D graphics formats",
   "license": "MIT",
   "type": "module",
@@ -45,12 +45,13 @@
     "stream": false
   },
   "dependencies": {
-    "@loaders.gl/schema": "4.3.0-alpha.1",
-    "@loaders.gl/worker-utils": "4.3.0-alpha.1",
+    "@loaders.gl/schema": "4.3.0-alpha.3",
+    "@loaders.gl/worker-utils": "4.3.0-alpha.3",
+    "@probe.gl/log": "^4.0.2",
     "@probe.gl/stats": "^4.0.2"
   },
   "peerDependencies": {
     "@loaders.gl/core": "^4.0.0"
   },
-  "gitHead": "568446ea69eb590f0c42d965459b636216cda74e"
+  "gitHead": "3213679d79e6ff2814d48fd3337acfa446c74099"
 }

package/src/index.ts

@@ -133,13 +133,14 @@ export type {FileSystem, RandomAccessFileSystem} from './lib/filesystems/filesys
 export {NodeFileSystemFacade as NodeFilesystem} from './lib/filesystems/node-filesystem-facade';
 
 // TODO - replace with ReadableFile
-export type {FileProvider} from './lib/file-provider/file-provider';
-export {isFileProvider} from './lib/file-provider/file-provider';
+export type {FileProviderInterface} from './lib/file-provider/file-provider-interface';
+export {isFileProvider} from './lib/file-provider/file-provider-interface';
+export {FileProvider} from './lib/file-provider/file-provider';
 export {FileHandleFile} from './lib/file-provider/file-handle-file';
 export {DataViewFile} from './lib/file-provider/data-view-file';
 
 // EXPERIMENTAL: DATA SOURCES
-export type {Service} from './service-types';
+export type {Source} from './source-types';
 
 export type {DataSourceProps} from './lib/sources/data-source';
 export {DataSource} from './lib/sources/data-source';
@@ -149,9 +150,13 @@ export type {ImageType} from './lib/sources/utils/image-type';
 export type {ImageSourceProps, ImageSourceMetadata} from './lib/sources/image-source';
 export type {GetImageParameters} from './lib/sources/image-source';
 
+export {VectorSource} from './lib/sources/vector-source';
+export type {VectorSourceProps, VectorSourceMetadata} from './lib/sources/vector-source';
+export type {GetFeaturesParameters} from './lib/sources/vector-source';
+
 export type {TileSource, TileSourceProps} from './lib/sources/tile-source';
 export type {TileSourceMetadata, GetTileParameters} from './lib/sources/tile-source';
-export type {TileLoadParameters} from './lib/sources/tile-source';
+export type {GetTileDataParameters} from './lib/sources/tile-source';
 
 export type {ImageTileSource} from './lib/sources/image-tile-source';
 

package/src/lib/file-provider/data-view-file.ts

@@ -1,4 +1,4 @@
-import {FileProvider} from './file-provider';
+import {FileProviderInterface} from './file-provider-interface';
 
 /**
  * Checks if bigint can be converted to number and convert it if possible
@@ -16,7 +16,7 @@ const toNumber = (bigint: bigint) => {
  * Provides file data using DataView
  * @deprecated - will be replaced with ReadableFile
  */
-export class DataViewFile implements FileProvider {
+export class DataViewFile implements FileProviderInterface {
   /** The DataView from which data is provided */
   private file: DataView;
 

package/src/lib/file-provider/file-handle-file.ts

@@ -2,14 +2,14 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import {FileProvider} from './file-provider';
+import {FileProviderInterface} from './file-provider-interface';
 import {NodeFileFacade as NodeFile} from '../files/node-file-facade';
 
 /**
  * Provides file data using node fs library
  * @deprecated - will be replaced with ReadableFile
  */
-export class FileHandleFile implements FileProvider {
+export class FileHandleFile implements FileProviderInterface {
   /** The FileHandle from which data is provided */
   private file: NodeFile;
 

package/src/lib/file-provider/file-provider-interface.ts

@@ -0,0 +1,56 @@
+/**
+ * Interface for providing file data
+ */
+export interface FileProviderInterface {
+  /**
+   * Cleanup class data
+   */
+  destroy(): Promise<void>;
+  /**
+   * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
+   * @param offset The offset, in bytes, from the start of the file where to read the data.
+   */
+  getUint8(offset: bigint): Promise<number>;
+
+  /**
+   * Gets an unsigned 16-bit integer at the specified byte offset from the start of the file.
+   * @param offset The offset, in bytes, from the start of the file where to read the data.
+   */
+  getUint16(offset: bigint): Promise<number>;
+
+  /**
+   * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+   * @param offset The offset, in bytes, from the file of the view where to read the data.
+   */
+  getUint32(offset: bigint): Promise<number>;
+
+  /**
+   * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
+   * @param offset The offset, in byte, from the file of the view where to read the data.
+   */
+  getBigUint64(offset: bigint): Promise<bigint>;
+
+  /**
+   * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
+   * @param startOffset The offset, in bytes, from the start of the file where to start reading the data.
+   * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
+   */
+  slice(startOffset: bigint, endOffset: bigint): Promise<ArrayBuffer>;
+
+  /**
+   * the length (in bytes) of the data.
+   */
+  length: bigint;
+}
+
+/**
+ * Check is the object has FileProvider members
+ * @param fileProvider - tested object
+ */
+export const isFileProvider = (fileProvider: unknown) => {
+  return (
+    (fileProvider as FileProviderInterface)?.getUint8 &&
+    (fileProvider as FileProviderInterface)?.slice &&
+    (fileProvider as FileProviderInterface)?.length
+  );
+};

package/src/lib/file-provider/file-provider.ts

@@ -1,57 +1,127 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import {ReadableFile} from '../files/file';
+import {FileProviderInterface} from './file-provider-interface';
+
 /**
- * Interface for providing file data
+ * Provides file data using range requests to the server
  * @deprecated - will be replaced with ReadableFile
  */
-export interface FileProvider {
+export class FileProvider implements FileProviderInterface {
+  /** The File object from which data is provided */
+  private file: ReadableFile;
+  private size: bigint;
+
+  /** Create a new BrowserFile */
+  private constructor(file: ReadableFile, size: bigint | number) {
+    this.file = file;
+    this.size = BigInt(size);
+  }
+
+  static async create(file: ReadableFile): Promise<FileProvider> {
+    return new FileProvider(
+      file,
+      file.bigsize > 0n
+        ? file.bigsize
+        : file.size > 0n
+        ? file.size
+        : (await file.stat?.())?.bigsize ?? 0n
+    );
+  }
+
   /**
-   * Cleanup class data
+   * Truncates the file descriptor.
+   * @param length desired file lenght
    */
-  destroy(): Promise<void>;
+  async truncate(length: number): Promise<void> {
+    throw new Error('file loaded via range requests cannot be changed');
+  }
+
+  /**
+   * Append data to a file.
+   * @param buffer data to append
+   */
+  async append(buffer: Uint8Array): Promise<void> {
+    throw new Error('file loaded via range requests cannot be changed');
+  }
+
+  /** Close file */
+  async destroy(): Promise<void> {
+    throw new Error('file loaded via range requests cannot be changed');
+  }
+
   /**
    * Gets an unsigned 8-bit integer at the specified byte offset from the start of the file.
    * @param offset The offset, in bytes, from the start of the file where to read the data.
    */
-  getUint8(offset: bigint): Promise<number>;
+  async getUint8(offset: number | bigint): Promise<number> {
+    const arrayBuffer = await this.file.read(offset, 1);
+    const val = new Uint8Array(arrayBuffer).at(0);
+    if (val === undefined) {
+      throw new Error('something went wrong');
+    }
+    return val;
+  }
 
   /**
    * Gets an unsigned 16-bit integer at the specified byte offset from the start of the file.
    * @param offset The offset, in bytes, from the start of the file where to read the data.
    */
-  getUint16(offset: bigint): Promise<number>;
+  async getUint16(offset: number | bigint): Promise<number> {
+    const arrayBuffer = await this.file.read(offset, 2);
+    const val = new Uint16Array(arrayBuffer).at(0);
+    if (val === undefined) {
+      throw new Error('something went wrong');
+    }
+    return val;
+  }
 
   /**
    * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in bytes, from the file of the view where to read the data.
+   * @param offset The offset, in bytes, from the start of the file where to read the data.
    */
-  getUint32(offset: bigint): Promise<number>;
+  async getUint32(offset: number | bigint): Promise<number> {
+    const arrayBuffer = await this.file.read(offset, 4);
+    const val = new Uint32Array(arrayBuffer).at(0);
+    if (val === undefined) {
+      throw new Error('something went wrong');
+    }
+    return val;
+  }
 
   /**
    * Gets an unsigned 32-bit integer at the specified byte offset from the start of the file.
-   * @param offset The offset, in byte, from the file of the view where to read the data.
+   * @param offset The offset, in bytes, from the start of the file where to read the data.
    */
-  getBigUint64(offset: bigint): Promise<bigint>;
+  async getBigUint64(offset: number | bigint): Promise<bigint> {
+    const arrayBuffer = await this.file.read(offset, 8);
+    const val = new BigInt64Array(arrayBuffer).at(0);
+    if (val === undefined) {
+      throw new Error('something went wrong');
+    }
+    return val;
+  }
 
   /**
    * returns an ArrayBuffer whose contents are a copy of this file bytes from startOffset, inclusive, up to endOffset, exclusive.
-   * @param startOffset The offset, in bytes, from the start of the file where to start reading the data.
+   * @param startOffset The offset, in byte, from the start of the file where to start reading the data.
    * @param endOffset The offset, in bytes, from the start of the file where to end reading the data.
    */
-  slice(startOffset: bigint, endOffset: bigint): Promise<ArrayBuffer>;
+  async slice(startOffset: bigint | number, endOffset: bigint | number): Promise<ArrayBuffer> {
+    const bigLength = BigInt(endOffset) - BigInt(startOffset);
+    if (bigLength > Number.MAX_SAFE_INTEGER) {
+      throw new Error('too big slice');
+    }
+    const length = Number(bigLength);
+
+    return await this.file.read(startOffset, length);
+  }
 
   /**
    * the length (in bytes) of the data.
    */
-  length: bigint;
+  get length(): bigint {
+    return this.size;
+  }
 }
-
-/**
- * Check is the object has FileProvider members
- * @param fileProvider - tested object
- */
-export const isFileProvider = (fileProvider: unknown) => {
-  return (
-    (fileProvider as FileProvider)?.getUint8 &&
-    (fileProvider as FileProvider)?.slice &&
-    (fileProvider as FileProvider)?.length
-  );
-};

package/src/lib/log-utils/log.ts

@@ -11,5 +11,18 @@ export const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'lates
 
 const version = VERSION[0] >= '0' && VERSION[0] <= '9' ? `v${VERSION}` : '';
 
-/** Global log instance */
-export const log: Log = new Log({id: `loaders.gl ${version}`});
+// Make sure we set the global variable
+function createLog() {
+  const log = new Log({id: 'loaders.gl'});
+
+  globalThis.loaders = globalThis.loaders || {};
+  globalThis.loaders.log = log;
+  globalThis.loaders.version = version;
+
+  globalThis.probe = globalThis.probe || {};
+  globalThis.probe.loaders = log;
+
+  return log;
+}
+
+export const log = createLog();

package/src/lib/sources/data-source.ts

@@ -6,6 +6,7 @@ import type {LoaderOptions} from '@loaders.gl/loader-utils';
 
 /** Common properties for all data sources */
 export type DataSourceProps = {
+  url?: string | Blob;
   /** LoaderOptions provide an option to override `fetch`. Will also be passed to any sub loaders */
   loadOptions?: LoaderOptions;
 };

package/src/lib/sources/image-source.ts

@@ -4,12 +4,30 @@
 
 import type {DataSourceProps} from './data-source';
 import {DataSource} from './data-source';
+// TODO - can we import from schema?
 import {ImageType} from './utils/image-type';
 
+export type ImageSourceProps = DataSourceProps;
+
+/**
+ * ImageSource - data sources that allow images to be queried by (geospatial) extents
+ */
+export abstract class ImageSource<
+  PropsT extends ImageSourceProps = ImageSourceProps
+> extends DataSource<PropsT> {
+  static type: string = 'template';
+  static testURL = (url: string): boolean => false;
+
+  abstract getMetadata(): Promise<ImageSourceMetadata>;
+  abstract getImage(parameters: GetImageParameters): Promise<ImageType>;
+}
+
+// PARAMETER TYPES
+
 /**
  * Normalized capabilities of an Image service
  * @example
- *  The WMSService will normalize the response to the WMS `GetCapabilities`
+ *  The WMSSourceLoader will normalize the response to the WMS `GetCapabilities`
  *  data structure extracted from WMS XML response into an ImageSourceMetadata.
  */
 export type ImageSourceMetadata = {
@@ -53,20 +71,3 @@ export type GetImageParameters = {
   /** requested format for the return image */
   format?: 'image/png';
 };
-
-export type ImageSourceProps = DataSourceProps;
-
-/**
- * MapImageSource - data sources that allow data to be queried by (geospatial) extents
- * @note
- * - If geospatial, bounding box is expected to be in web mercator coordinates
- */
-export abstract class ImageSource<
-  PropsT extends ImageSourceProps = ImageSourceProps
-> extends DataSource<PropsT> {
-  static type: string = 'template';
-  static testURL = (url: string): boolean => false;
-
-  abstract getMetadata(): Promise<ImageSourceMetadata>;
-  abstract getImage(parameters: GetImageParameters): Promise<ImageType>;
-}

package/src/lib/sources/image-tile-source.ts

@@ -3,14 +3,18 @@
 // Copyright (c) vis.gl contributors
 
 import type {ImageType} from './utils/image-type';
-import type {TileSource, TileSourceMetadata} from './tile-source';
-import type {GetTileParameters} from './tile-source';
+import type {TileSourceProps, TileSourceMetadata, GetTileParameters} from './tile-source';
+import type {TileSource} from './tile-source';
+
+export type ImageTileSourceProps = TileSourceProps;
 
 /**
  * MapTileSource - data sources that allow data to be queried by (geospatial) tile
  * @note If geospatial, bounding box is expected to be in web mercator coordinates
  */
-export interface ImageTileSource<MetadataT extends TileSourceMetadata = TileSourceMetadata>
-  extends TileSource<MetadataT> {
+export interface ImageTileSource<
+  PropsT extends TileSourceProps = TileSourceProps,
+  MetadataT extends TileSourceMetadata = TileSourceMetadata
+> extends TileSource<PropsT, MetadataT> {
   getImageTile(parameters: GetTileParameters): Promise<ImageType | null>;
 }

package/src/lib/sources/tile-source-adapter.ts

@@ -1,7 +1,7 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 
-import {TileSource, GetTileParameters} from './tile-source';
+import {TileSource, GetTileParameters, GetTileDataParameters} from './tile-source';
 import {ImageSource, ImageSourceMetadata} from './image-source';
 
 /**
@@ -9,6 +9,7 @@ import {ImageSource, ImageSourceMetadata} from './image-source';
  * @note
  * - If geospatial, bounding box is expected to be in web mercator coordinates
  */
+// @ts-expect-error TODO - does not implement all DataSource members
 export class TileSourceAdapter implements TileSource<ImageSourceMetadata> {
   readonly viewportSource: ImageSource;
   constructor(source: ImageSource) {
@@ -27,9 +28,9 @@ export class TileSourceAdapter implements TileSource<ImageSourceMetadata> {
   }
 
   /** deck.gl style parameters */
-  // getTileData(parameters: TileLoadParameters): Promise<unknown | null> {
-  //   return this.viewportSource.getImage
-  // }
+  getTileData(parameters: GetTileDataParameters): Promise<unknown | null> {
+    return this.getTile(parameters.index);
+  }
 
   /** Bounding box of tiles in this tileset `[[w, s], [e, n]]`  */
   protected getTileBoundingBox(