@loaders.gl/loader-utils 4.0.0-alpha.5 → 4.0.0-alpha.6

package/dist/index.js

@@ -1,26 +1,122 @@
-export { assert } from './lib/env-utils/assert';
-export { isBrowser, isWorker, nodeVersion, self, window, global, document } from './lib/env-utils/globals';
-export { createLoaderWorker } from './lib/worker-loader-utils/create-loader-worker';
-export { parseWithWorker, canParseWithWorker } from './lib/worker-loader-utils/parse-with-worker';
-export { parseJSON } from './lib/parser-utils/parse-json';
-export { toArrayBuffer, sliceArrayBuffer, concatenateArrayBuffers, concatenateTypedArrays, compareArrayBuffers } from './lib/binary-utils/array-buffer-utils';
-export { padToNBytes, copyToArray, copyArrayBuffer } from './lib/binary-utils/memory-copy-utils';
-export { copyPaddedArrayBufferToDataView, copyPaddedStringToDataView } from './lib/binary-utils/binary-copy-utils';
-export { padStringToByteAlignment, copyStringToDataView, copyBinaryToDataView } from './lib/binary-utils/encode-utils';
-export { getFirstCharacters, getMagicString } from './lib/binary-utils/get-first-characters';
-export { makeTextEncoderIterator, makeTextDecoderIterator, makeLineIterator, makeNumberedLineIterator } from './lib/iterators/text-iterators';
-export { forEach, concatenateArrayBuffersAsync } from './lib/iterators/async-iteration';
-export { default as RequestScheduler } from './lib/request-utils/request-scheduler';
-export { setPathPrefix, getPathPrefix, resolvePath } from './lib/path-utils/file-aliases';
-export { addAliases as _addAliases } from './lib/path-utils/file-aliases';
-export { JSONLoader } from './json-loader';
-import * as path from './lib/path-utils/path';
-export { path };
-export { isBuffer, toBuffer, bufferToArrayBuffer } from './lib/binary-utils/buffer-utils';
-import * as util from './lib/node/util';
-export { util };
-export { promisify } from './lib/node/util';
-import * as fs from './lib/node/fs';
-export { fs };
-export { default as _NodeFileSystem } from './lib/filesystems/node-filesystem';
-//# sourceMappingURL=index.js.map
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeWritableFile = exports.makeReadableFile = exports.stream = exports.fs = exports.path = exports.promisify2 = exports.promisify1 = exports.toArrayBuffer = exports.toBuffer = exports.isBuffer = exports.JSONLoader = exports._addAliases = exports.resolvePath = exports.getPathPrefix = exports.setPathPrefix = exports.RequestScheduler = exports.concatenateArrayBuffersAsync = exports.forEach = exports.makeNumberedLineIterator = exports.makeLineIterator = exports.makeTextDecoderIterator = exports.makeTextEncoderIterator = exports.getMagicString = exports.getFirstCharacters = exports.copyPaddedStringToDataView = exports.copyPaddedArrayBufferToDataView = exports.copyBinaryToDataView = exports.copyStringToDataView = exports.padStringToByteAlignment = exports.copyArrayBuffer = exports.copyToArray = exports.padToNBytes = exports.compareArrayBuffers = exports.concatenateTypedArrays = exports.concatenateArrayBuffers = exports.sliceArrayBuffer = exports.parseJSON = exports.canEncodeWithWorker = exports.canParseWithWorker = exports.parseWithWorker = exports.createLoaderWorker = exports.mergeLoaderOptions = exports.document = exports.global = exports.window = exports.self = exports.nodeVersion = exports.isWorker = exports.isBrowser = exports.assert = void 0;
+exports._NodeFileSystem = void 0;
+// GENERAL UTILS
+var assert_1 = require("./lib/env-utils/assert");
+Object.defineProperty(exports, "assert", { enumerable: true, get: function () { return assert_1.assert; } });
+var globals_1 = require("./lib/env-utils/globals");
+Object.defineProperty(exports, "isBrowser", { enumerable: true, get: function () { return globals_1.isBrowser; } });
+Object.defineProperty(exports, "isWorker", { enumerable: true, get: function () { return globals_1.isWorker; } });
+Object.defineProperty(exports, "nodeVersion", { enumerable: true, get: function () { return globals_1.nodeVersion; } });
+Object.defineProperty(exports, "self", { enumerable: true, get: function () { return globals_1.self; } });
+Object.defineProperty(exports, "window", { enumerable: true, get: function () { return globals_1.window; } });
+Object.defineProperty(exports, "global", { enumerable: true, get: function () { return globals_1.global; } });
+Object.defineProperty(exports, "document", { enumerable: true, get: function () { return globals_1.document; } });
+var merge_loader_options_1 = require("./lib/option-utils/merge-loader-options");
+Object.defineProperty(exports, "mergeLoaderOptions", { enumerable: true, get: function () { return merge_loader_options_1.mergeLoaderOptions; } });
+// LOADERS.GL-SPECIFIC WORKER UTILS
+var create_loader_worker_1 = require("./lib/worker-loader-utils/create-loader-worker");
+Object.defineProperty(exports, "createLoaderWorker", { enumerable: true, get: function () { return create_loader_worker_1.createLoaderWorker; } });
+var parse_with_worker_1 = require("./lib/worker-loader-utils/parse-with-worker");
+Object.defineProperty(exports, "parseWithWorker", { enumerable: true, get: function () { return parse_with_worker_1.parseWithWorker; } });
+Object.defineProperty(exports, "canParseWithWorker", { enumerable: true, get: function () { return parse_with_worker_1.canParseWithWorker; } });
+var encode_with_worker_1 = require("./lib/worker-loader-utils/encode-with-worker");
+Object.defineProperty(exports, "canEncodeWithWorker", { enumerable: true, get: function () { return encode_with_worker_1.canEncodeWithWorker; } });
+// PARSER UTILS
+var parse_json_1 = require("./lib/parser-utils/parse-json");
+Object.defineProperty(exports, "parseJSON", { enumerable: true, get: function () { return parse_json_1.parseJSON; } });
+// MEMORY COPY UTILS
+var array_buffer_utils_1 = require("./lib/binary-utils/array-buffer-utils");
+Object.defineProperty(exports, "sliceArrayBuffer", { enumerable: true, get: function () { return array_buffer_utils_1.sliceArrayBuffer; } });
+Object.defineProperty(exports, "concatenateArrayBuffers", { enumerable: true, get: function () { return array_buffer_utils_1.concatenateArrayBuffers; } });
+Object.defineProperty(exports, "concatenateTypedArrays", { enumerable: true, get: function () { return array_buffer_utils_1.concatenateTypedArrays; } });
+Object.defineProperty(exports, "compareArrayBuffers", { enumerable: true, get: function () { return array_buffer_utils_1.compareArrayBuffers; } });
+var memory_copy_utils_1 = require("./lib/binary-utils/memory-copy-utils");
+Object.defineProperty(exports, "padToNBytes", { enumerable: true, get: function () { return memory_copy_utils_1.padToNBytes; } });
+Object.defineProperty(exports, "copyToArray", { enumerable: true, get: function () { return memory_copy_utils_1.copyToArray; } });
+Object.defineProperty(exports, "copyArrayBuffer", { enumerable: true, get: function () { return memory_copy_utils_1.copyArrayBuffer; } });
+var dataview_copy_utils_1 = require("./lib/binary-utils/dataview-copy-utils");
+Object.defineProperty(exports, "padStringToByteAlignment", { enumerable: true, get: function () { return dataview_copy_utils_1.padStringToByteAlignment; } });
+Object.defineProperty(exports, "copyStringToDataView", { enumerable: true, get: function () { return dataview_copy_utils_1.copyStringToDataView; } });
+Object.defineProperty(exports, "copyBinaryToDataView", { enumerable: true, get: function () { return dataview_copy_utils_1.copyBinaryToDataView; } });
+Object.defineProperty(exports, "copyPaddedArrayBufferToDataView", { enumerable: true, get: function () { return dataview_copy_utils_1.copyPaddedArrayBufferToDataView; } });
+Object.defineProperty(exports, "copyPaddedStringToDataView", { enumerable: true, get: function () { return dataview_copy_utils_1.copyPaddedStringToDataView; } });
+var get_first_characters_1 = require("./lib/binary-utils/get-first-characters");
+Object.defineProperty(exports, "getFirstCharacters", { enumerable: true, get: function () { return get_first_characters_1.getFirstCharacters; } });
+Object.defineProperty(exports, "getMagicString", { enumerable: true, get: function () { return get_first_characters_1.getMagicString; } });
+// ITERATOR UTILS
+var text_iterators_1 = require("./lib/iterators/text-iterators");
+Object.defineProperty(exports, "makeTextEncoderIterator", { enumerable: true, get: function () { return text_iterators_1.makeTextEncoderIterator; } });
+Object.defineProperty(exports, "makeTextDecoderIterator", { enumerable: true, get: function () { return text_iterators_1.makeTextDecoderIterator; } });
+Object.defineProperty(exports, "makeLineIterator", { enumerable: true, get: function () { return text_iterators_1.makeLineIterator; } });
+Object.defineProperty(exports, "makeNumberedLineIterator", { enumerable: true, get: function () { return text_iterators_1.makeNumberedLineIterator; } });
+var async_iteration_1 = require("./lib/iterators/async-iteration");
+Object.defineProperty(exports, "forEach", { enumerable: true, get: function () { return async_iteration_1.forEach; } });
+Object.defineProperty(exports, "concatenateArrayBuffersAsync", { enumerable: true, get: function () { return async_iteration_1.concatenateArrayBuffersAsync; } });
+// REQUEST UTILS
+var request_scheduler_1 = require("./lib/request-utils/request-scheduler");
+Object.defineProperty(exports, "RequestScheduler", { enumerable: true, get: function () { return __importDefault(request_scheduler_1).default; } });
+// PATH HELPERS
+var file_aliases_1 = require("./lib/path-utils/file-aliases");
+Object.defineProperty(exports, "setPathPrefix", { enumerable: true, get: function () { return file_aliases_1.setPathPrefix; } });
+Object.defineProperty(exports, "getPathPrefix", { enumerable: true, get: function () { return file_aliases_1.getPathPrefix; } });
+Object.defineProperty(exports, "resolvePath", { enumerable: true, get: function () { return file_aliases_1.resolvePath; } });
+var file_aliases_2 = require("./lib/path-utils/file-aliases");
+Object.defineProperty(exports, "_addAliases", { enumerable: true, get: function () { return file_aliases_2.addAliases; } });
+// MICRO LOADERS
+var json_loader_1 = require("./json-loader");
+Object.defineProperty(exports, "JSONLoader", { enumerable: true, get: function () { return json_loader_1.JSONLoader; } });
+// NODE support
+// Node.js emulation (can be used in browser)
+// Avoid direct use of `Buffer` which pulls in 50KB polyfill
+var memory_conversion_utils_1 = require("./lib/binary-utils/memory-conversion-utils");
+Object.defineProperty(exports, "isBuffer", { enumerable: true, get: function () { return memory_conversion_utils_1.isBuffer; } });
+Object.defineProperty(exports, "toBuffer", { enumerable: true, get: function () { return memory_conversion_utils_1.toBuffer; } });
+Object.defineProperty(exports, "toArrayBuffer", { enumerable: true, get: function () { return memory_conversion_utils_1.toArrayBuffer; } });
+// Note.js wrappers (can be safely imported, but not used in browser)
+// Use instead of importing 'util' to avoid node dependencies
+var promisify_1 = require("./lib/node/promisify");
+Object.defineProperty(exports, "promisify1", { enumerable: true, get: function () { return promisify_1.promisify1; } });
+Object.defineProperty(exports, "promisify2", { enumerable: true, get: function () { return promisify_1.promisify2; } });
+// `path` replacement (avoids bundling big path polyfill)
+const path = __importStar(require("./lib/path-utils/path"));
+exports.path = path;
+// Use instead of importing 'fs' to avoid node dependencies`
+const fs = __importStar(require("./lib/node/fs"));
+exports.fs = fs;
+// Use instead of importing 'stream' to avoid node dependencies`
+const stream = __importStar(require("./lib/node/stream"));
+exports.stream = stream;
+var readable_file_1 = require("./lib/filesystems/readable-file");
+Object.defineProperty(exports, "makeReadableFile", { enumerable: true, get: function () { return readable_file_1.makeReadableFile; } });
+var writable_file_1 = require("./lib/filesystems/writable-file");
+Object.defineProperty(exports, "makeWritableFile", { enumerable: true, get: function () { return writable_file_1.makeWritableFile; } });
+var node_filesystem_1 = require("./lib/filesystems/node-filesystem");
+Object.defineProperty(exports, "_NodeFileSystem", { enumerable: true, get: function () { return __importDefault(node_filesystem_1).default; } });

package/dist/json-loader.d.ts

@@ -1,22 +1,9 @@
-import type { LoaderWithParser } from './types';
+import type { LoaderWithParser, LoaderOptions } from './types';
+import type { Table, TableBatch } from '@loaders.gl/schema';
+export type JSONLoaderOptions = LoaderOptions;
 /**
  * A JSON Micro loader (minimal bundle size)
  * Alternative to `@loaders.gl/json`
  */
-export declare const JSONLoader: {
-    name: string;
-    id: string;
-    module: string;
-    version: any;
-    extensions: string[];
-    mimeTypes: string[];
-    category: string;
-    text: boolean;
-    parseTextSync: typeof parseTextSync;
-    parse: (arrayBuffer: any) => Promise<any>;
-    options: {};
-};
-declare function parseTextSync(text: any): any;
-export declare const _typecheckJSONLoader: LoaderWithParser;
-export {};
+export declare const JSONLoader: LoaderWithParser<Table, TableBatch, JSONLoaderOptions>;
 //# sourceMappingURL=json-loader.d.ts.map

package/dist/json-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json-loader.d.ts","sourceRoot":"","sources":["../src/json-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,SAAS,CAAC;AAM9C;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;CAYtB,CAAC;AAGF,iBAAS,aAAa,CAAC,IAAI,KAAA,OAE1B;AAED,eAAO,MAAM,oBAAoB,EAAE,gBAA6B,CAAC"}
+{"version":3,"file":"json-loader.d.ts","sourceRoot":"","sources":["../src/json-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAE,aAAa,EAAC,MAAM,SAAS,CAAC;AAC7D,OAAO,KAAK,EAAC,KAAK,EAAE,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAM1D,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,iBAAiB,CAY7E,CAAC"}

package/dist/json-loader.js

@@ -1,21 +1,27 @@
-const VERSION = typeof "4.0.0-alpha.5" !== 'undefined' ? "4.0.0-alpha.5" : 'latest';
-export const JSONLoader = {
-  name: 'JSON',
-  id: 'json',
-  module: 'json',
-  version: VERSION,
-  extensions: ['json', 'geojson'],
-  mimeTypes: ['application/json'],
-  category: 'json',
-  text: true,
-  parseTextSync,
-  parse: async arrayBuffer => parseTextSync(new TextDecoder().decode(arrayBuffer)),
-  options: {}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JSONLoader = void 0;
+// __VERSION__ is injected by babel-plugin-version-inline
+// @ts-ignore TS2304: Cannot find name '__VERSION__'.
+const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
+/**
+ * A JSON Micro loader (minimal bundle size)
+ * Alternative to `@loaders.gl/json`
+ */
+exports.JSONLoader = {
+    name: 'JSON',
+    id: 'json',
+    module: 'json',
+    version: VERSION,
+    extensions: ['json', 'geojson'],
+    mimeTypes: ['application/json'],
+    category: 'json',
+    text: true,
+    parseTextSync,
+    parse: async (arrayBuffer) => parseTextSync(new TextDecoder().decode(arrayBuffer)),
+    options: {}
 };
-
+// TODO - deprecated
 function parseTextSync(text) {
-  return JSON.parse(text);
+    return JSON.parse(text);
 }
-
-export const _typecheckJSONLoader = JSONLoader;
-//# sourceMappingURL=json-loader.js.map

package/dist/lib/binary-utils/array-buffer-utils.d.ts

@@ -1,12 +1,8 @@
-/**
- * Convert an object to an array buffer
- */
-export declare function toArrayBuffer(data: any): ArrayBuffer;
 /**
  * compare two binary arrays for equality
- * @param {ArrayBuffer} a
- * @param {ArrayBuffer} b
- * @param {number} byteLength
+ * @param a
+ * @param b
+ * @param byteLength
  */
 export declare function compareArrayBuffers(arrayBuffer1: ArrayBuffer, arrayBuffer2: ArrayBuffer, byteLength?: number): boolean;
 /**
@@ -17,7 +13,7 @@ export declare function concatenateArrayBuffers(...sources: (ArrayBuffer | Uint8
 /**
  * Concatenate arbitrary count of typed arrays
  * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Typed_arrays
- * @param {...*} arrays - list of arrays. All arrays should be the same type
+ * @param - list of arrays. All arrays should be the same type
  * @return A concatenated TypedArray
  */
 export declare function concatenateTypedArrays<T>(...typedArrays: T[]): T;

package/dist/lib/binary-utils/array-buffer-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"array-buffer-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/array-buffer-utils.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,WAAW,CA8BpD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,WAAW,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAaT;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,UAAU,CAAC,EAAE,GAAG,WAAW,CAqB7F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,CAAC,EAAE,GAAG,CAAC,CAoBhE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW,CAOb"}
+{"version":3,"file":"array-buffer-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/array-buffer-utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,WAAW,EACzB,YAAY,EAAE,WAAW,EACzB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAaT;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,UAAU,CAAC,EAAE,GAAG,WAAW,CAqB7F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,GAAG,WAAW,EAAE,CAAC,EAAE,GAAG,CAAC,CAoBhE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,GAClB,WAAW,CAOb"}

package/dist/lib/binary-utils/array-buffer-utils.js

@@ -1,86 +1,84 @@
-import { isBuffer, bufferToArrayBuffer } from './buffer-utils';
-export function toArrayBuffer(data) {
-  if (isBuffer(data)) {
-    return bufferToArrayBuffer(data);
-  }
-
-  if (data instanceof ArrayBuffer) {
-    return data;
-  }
-
-  if (ArrayBuffer.isView(data)) {
-    if (data.byteOffset === 0 && data.byteLength === data.buffer.byteLength) {
-      return data.buffer;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sliceArrayBuffer = exports.concatenateTypedArrays = exports.concatenateArrayBuffers = exports.compareArrayBuffers = void 0;
+/**
+ * compare two binary arrays for equality
+ * @param a
+ * @param b
+ * @param byteLength
+ */
+function compareArrayBuffers(arrayBuffer1, arrayBuffer2, byteLength) {
+    byteLength = byteLength || arrayBuffer1.byteLength;
+    if (arrayBuffer1.byteLength < byteLength || arrayBuffer2.byteLength < byteLength) {
+        return false;
     }
-
-    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
-  }
-
-  if (typeof data === 'string') {
-    const text = data;
-    const uint8Array = new TextEncoder().encode(text);
-    return uint8Array.buffer;
-  }
-
-  if (data && typeof data === 'object' && data._toArrayBuffer) {
-    return data._toArrayBuffer();
-  }
-
-  throw new Error('toArrayBuffer');
-}
-export function compareArrayBuffers(arrayBuffer1, arrayBuffer2, byteLength) {
-  byteLength = byteLength || arrayBuffer1.byteLength;
-
-  if (arrayBuffer1.byteLength < byteLength || arrayBuffer2.byteLength < byteLength) {
-    return false;
-  }
-
-  const array1 = new Uint8Array(arrayBuffer1);
-  const array2 = new Uint8Array(arrayBuffer2);
-
-  for (let i = 0; i < array1.length; ++i) {
-    if (array1[i] !== array2[i]) {
-      return false;
+    const array1 = new Uint8Array(arrayBuffer1);
+    const array2 = new Uint8Array(arrayBuffer2);
+    for (let i = 0; i < array1.length; ++i) {
+        if (array1[i] !== array2[i]) {
+            return false;
+        }
     }
-  }
-
-  return true;
+    return true;
 }
-export function concatenateArrayBuffers(...sources) {
-  const sourceArrays = sources.map(source2 => source2 instanceof ArrayBuffer ? new Uint8Array(source2) : source2);
-  const byteLength = sourceArrays.reduce((length, typedArray) => length + typedArray.byteLength, 0);
-  const result = new Uint8Array(byteLength);
-  let offset = 0;
-
-  for (const sourceArray of sourceArrays) {
-    result.set(sourceArray, offset);
-    offset += sourceArray.byteLength;
-  }
-
-  return result.buffer;
+exports.compareArrayBuffers = compareArrayBuffers;
+/**
+ * Concatenate a sequence of ArrayBuffers
+ * @return A concatenated ArrayBuffer
+ */
+function concatenateArrayBuffers(...sources) {
+    // Make sure all inputs are wrapped in typed arrays
+    const sourceArrays = sources.map((source2) => source2 instanceof ArrayBuffer ? new Uint8Array(source2) : source2);
+    // Get length of all inputs
+    const byteLength = sourceArrays.reduce((length, typedArray) => length + typedArray.byteLength, 0);
+    // Allocate array with space for all inputs
+    const result = new Uint8Array(byteLength);
+    // Copy the subarrays
+    let offset = 0;
+    for (const sourceArray of sourceArrays) {
+        result.set(sourceArray, offset);
+        offset += sourceArray.byteLength;
+    }
+    // We work with ArrayBuffers, discard the typed array wrapper
+    return result.buffer;
 }
-export function concatenateTypedArrays(...typedArrays) {
-  const arrays = typedArrays;
-  const TypedArrayConstructor = arrays && arrays.length > 1 && arrays[0].constructor || null;
-
-  if (!TypedArrayConstructor) {
-    throw new Error('"concatenateTypedArrays" - incorrect quantity of arguments or arguments have incompatible data types');
-  }
-
-  const sumLength = arrays.reduce((acc, value) => acc + value.length, 0);
-  const result = new TypedArrayConstructor(sumLength);
-  let offset = 0;
-
-  for (const array of arrays) {
-    result.set(array, offset);
-    offset += array.length;
-  }
-
-  return result;
+exports.concatenateArrayBuffers = concatenateArrayBuffers;
+/**
+ * Concatenate arbitrary count of typed arrays
+ * https://developer.mozilla.org/en-US/docs/Web/JavaScript/Typed_arrays
+ * @param - list of arrays. All arrays should be the same type
+ * @return A concatenated TypedArray
+ */
+function concatenateTypedArrays(...typedArrays) {
+    // @ts-ignore
+    const arrays = typedArrays;
+    // @ts-ignore
+    const TypedArrayConstructor = (arrays && arrays.length > 1 && arrays[0].constructor) || null;
+    if (!TypedArrayConstructor) {
+        throw new Error('"concatenateTypedArrays" - incorrect quantity of arguments or arguments have incompatible data types');
+    }
+    const sumLength = arrays.reduce((acc, value) => acc + value.length, 0);
+    // @ts-ignore typescript does not like dynamic constructors
+    const result = new TypedArrayConstructor(sumLength);
+    let offset = 0;
+    for (const array of arrays) {
+        result.set(array, offset);
+        offset += array.length;
+    }
+    return result;
 }
-export function sliceArrayBuffer(arrayBuffer, byteOffset, byteLength) {
-  const subArray = byteLength !== undefined ? new Uint8Array(arrayBuffer).subarray(byteOffset, byteOffset + byteLength) : new Uint8Array(arrayBuffer).subarray(byteOffset);
-  const arrayCopy = new Uint8Array(subArray);
-  return arrayCopy.buffer;
+exports.concatenateTypedArrays = concatenateTypedArrays;
+/**
+ * Copy a view of an ArrayBuffer into new ArrayBuffer with byteOffset = 0
+ * @param arrayBuffer
+ * @param byteOffset
+ * @param byteLength
+ */
+function sliceArrayBuffer(arrayBuffer, byteOffset, byteLength) {
+    const subArray = byteLength !== undefined
+        ? new Uint8Array(arrayBuffer).subarray(byteOffset, byteOffset + byteLength)
+        : new Uint8Array(arrayBuffer).subarray(byteOffset);
+    const arrayCopy = new Uint8Array(subArray);
+    return arrayCopy.buffer;
 }
-//# sourceMappingURL=array-buffer-utils.js.map
+exports.sliceArrayBuffer = sliceArrayBuffer;

package/dist/lib/binary-utils/dataview-copy-utils.d.ts

@@ -0,0 +1,43 @@
+import { TypedArray } from '../../types';
+/**
+ * Helper function that pads a string with spaces to fit a certain byte alignment
+ * @param string
+ * @param byteAlignment
+ * @returns
+ *
+ * @todo PERFORMANCE IDEA: No need to copy string twice...
+ */
+export declare function padStringToByteAlignment(string: string, byteAlignment: number): string;
+/**
+ *
+ * @param dataView
+ * @param byteOffset
+ * @param string
+ * @param byteLength
+ * @returns
+ */
+export declare function copyStringToDataView(dataView: DataView, byteOffset: number, string: string, byteLength: number): number;
+export declare function copyBinaryToDataView(dataView: any, byteOffset: any, binary: any, byteLength: any): any;
+/**
+ * Copy sourceBuffer to dataView with some padding
+ *
+ * @param dataView - destination data container. If null - only new offset is calculated
+ * @param byteOffset - destination byte offset to copy to
+ * @param sourceBuffer - source data buffer
+ * @param padding - pad the resulting array to multiple of "padding" bytes. Additional bytes are filled with 0x20 (ASCII space)
+ *
+ * @return new byteOffset of resulting dataView
+ */
+export declare function copyPaddedArrayBufferToDataView(dataView: DataView | null, byteOffset: number, sourceBuffer: TypedArray, padding: number): number;
+/**
+ * Copy string to dataView with some padding
+ *
+ * @param {DataView | null} dataView - destination data container. If null - only new offset is calculated
+ * @param {number} byteOffset - destination byte offset to copy to
+ * @param {string} string - source string
+ * @param {number} padding - pad the resulting array to multiple of "padding" bytes. Additional bytes are filled with 0x20 (ASCII space)
+ *
+ * @return new byteOffset of resulting dataView
+ */
+export declare function copyPaddedStringToDataView(dataView: DataView | null, byteOffset: number, string: string, padding: number): number;
+//# sourceMappingURL=dataview-copy-utils.d.ts.map

package/dist/lib/binary-utils/dataview-copy-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataview-copy-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/dataview-copy-utils.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAGvC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAStF;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAOR;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,KAAA,EAAE,UAAU,KAAA,EAAE,MAAM,KAAA,EAAE,UAAU,KAAA,OAO5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,UAAU,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,CAsBR;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,MAAM,CASR"}

package/dist/lib/binary-utils/dataview-copy-utils.js

@@ -0,0 +1,97 @@
+"use strict";
+// loaders./gl, MIT license
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copyPaddedStringToDataView = exports.copyPaddedArrayBufferToDataView = exports.copyBinaryToDataView = exports.copyStringToDataView = exports.padStringToByteAlignment = void 0;
+const memory_copy_utils_1 = require("./memory-copy-utils");
+/**
+ * Helper function that pads a string with spaces to fit a certain byte alignment
+ * @param string
+ * @param byteAlignment
+ * @returns
+ *
+ * @todo PERFORMANCE IDEA: No need to copy string twice...
+ */
+function padStringToByteAlignment(string, byteAlignment) {
+    const length = string.length;
+    const paddedLength = Math.ceil(length / byteAlignment) * byteAlignment; // Round up to the required alignment
+    const padding = paddedLength - length;
+    let whitespace = '';
+    for (let i = 0; i < padding; ++i) {
+        whitespace += ' ';
+    }
+    return string + whitespace;
+}
+exports.padStringToByteAlignment = padStringToByteAlignment;
+/**
+ *
+ * @param dataView
+ * @param byteOffset
+ * @param string
+ * @param byteLength
+ * @returns
+ */
+function copyStringToDataView(dataView, byteOffset, string, byteLength) {
+    if (dataView) {
+        for (let i = 0; i < byteLength; i++) {
+            dataView.setUint8(byteOffset + i, string.charCodeAt(i));
+        }
+    }
+    return byteOffset + byteLength;
+}
+exports.copyStringToDataView = copyStringToDataView;
+function copyBinaryToDataView(dataView, byteOffset, binary, byteLength) {
+    if (dataView) {
+        for (let i = 0; i < byteLength; i++) {
+            dataView.setUint8(byteOffset + i, binary[i]);
+        }
+    }
+    return byteOffset + byteLength;
+}
+exports.copyBinaryToDataView = copyBinaryToDataView;
+/**
+ * Copy sourceBuffer to dataView with some padding
+ *
+ * @param dataView - destination data container. If null - only new offset is calculated
+ * @param byteOffset - destination byte offset to copy to
+ * @param sourceBuffer - source data buffer
+ * @param padding - pad the resulting array to multiple of "padding" bytes. Additional bytes are filled with 0x20 (ASCII space)
+ *
+ * @return new byteOffset of resulting dataView
+ */
+function copyPaddedArrayBufferToDataView(dataView, byteOffset, sourceBuffer, padding) {
+    const paddedLength = (0, memory_copy_utils_1.padToNBytes)(sourceBuffer.byteLength, padding);
+    const padLength = paddedLength - sourceBuffer.byteLength;
+    if (dataView) {
+        // Copy array
+        const targetArray = new Uint8Array(dataView.buffer, dataView.byteOffset + byteOffset, sourceBuffer.byteLength);
+        const sourceArray = new Uint8Array(sourceBuffer);
+        targetArray.set(sourceArray);
+        // Add PADDING
+        for (let i = 0; i < padLength; ++i) {
+            // json chunk is padded with spaces (ASCII 0x20)
+            dataView.setUint8(byteOffset + sourceBuffer.byteLength + i, 0x20);
+        }
+    }
+    byteOffset += paddedLength;
+    return byteOffset;
+}
+exports.copyPaddedArrayBufferToDataView = copyPaddedArrayBufferToDataView;
+/**
+ * Copy string to dataView with some padding
+ *
+ * @param {DataView | null} dataView - destination data container. If null - only new offset is calculated
+ * @param {number} byteOffset - destination byte offset to copy to
+ * @param {string} string - source string
+ * @param {number} padding - pad the resulting array to multiple of "padding" bytes. Additional bytes are filled with 0x20 (ASCII space)
+ *
+ * @return new byteOffset of resulting dataView
+ */
+function copyPaddedStringToDataView(dataView, byteOffset, string, padding) {
+    const textEncoder = new TextEncoder();
+    // PERFORMANCE IDEA: We encode twice, once to get size and once to store
+    // PERFORMANCE IDEA: Use TextEncoder.encodeInto() to avoid temporary copy
+    const stringBuffer = textEncoder.encode(string);
+    byteOffset = copyPaddedArrayBufferToDataView(dataView, byteOffset, stringBuffer, padding);
+    return byteOffset;
+}
+exports.copyPaddedStringToDataView = copyPaddedStringToDataView;

package/dist/lib/binary-utils/get-first-characters.d.ts

@@ -1,3 +1,17 @@
-export declare function getFirstCharacters(data: any, length?: number): string;
+/**
+ * Get the first characters from a binary file (interpret the first bytes as an ASCII string)
+ * @param data
+ * @param length
+ * @returns
+ */
+export declare function getFirstCharacters(data: string | ArrayBuffer, length?: number): string;
+/**
+ * Gets a magic string from a "file"
+ * Typically used to check or detect file format
+ * @param arrayBuffer
+ * @param byteOffset
+ * @param length
+ * @returns
+ */
 export declare function getMagicString(arrayBuffer: ArrayBuffer, byteOffset: number, length: number): string;
 //# sourceMappingURL=get-first-characters.d.ts.map

package/dist/lib/binary-utils/get-first-characters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-first-characters.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/get-first-characters.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,IAAI,KAAA,EAAE,MAAM,SAAI,GAAG,MAAM,CAW3D;AAED,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,CAUR"}
+{"version":3,"file":"get-first-characters.d.ts","sourceRoot":"","sources":["../../../src/lib/binary-utils/get-first-characters.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAWzF;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,EACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,MAAM,CAUR"}