@atlaspack/utils 2.14.5-canary.137 → 2.14.5-canary.139

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @atlaspack/utils
 
+## 2.17.3
+
+### Patch Changes
+
+- Updated dependencies [[`069de47`](https://github.com/atlassian-labs/atlaspack/commit/069de478e64fb5889f6f2ce023eb510782767fbd)]:
+  - @atlaspack/feature-flags@2.20.0
+
 ## 2.17.2
 
 ### Patch Changes

package/lib/DefaultMap.d.ts

@@ -0,0 +1,13 @@
+export declare class DefaultMap<K, V> extends Map<K, V> {
+    _getDefault: (arg1: K) => V;
+    constructor(getDefault: (arg1: K) => V, entries?: Iterable<[K, V]>);
+    get(key: K): V;
+}
+interface Key {
+}
+export declare class DefaultWeakMap<K extends Key, V> extends WeakMap<K, V> {
+    _getDefault: (arg1: K) => V;
+    constructor(getDefault: (arg1: K) => V, entries?: Iterable<[K, V]>);
+    get(key: K): V;
+}
+export {};

package/lib/DefaultMap.js

@@ -17,8 +17,6 @@ class DefaultMap extends Map {
       ret = this._getDefault(key);
       this.set(key, ret);
     }
-
-    // $FlowFixMe
     return ret;
   }
 }
@@ -38,8 +36,6 @@ class DefaultWeakMap extends WeakMap {
       ret = this._getDefault(key);
       this.set(key, ret);
     }
-
-    // $FlowFixMe
     return ret;
   }
 }

package/lib/Deferred.d.ts

@@ -0,0 +1,8 @@
+export type Deferred<T> = {
+    resolve(arg1: T): void;
+    reject(arg1: unknown): void;
+};
+export declare function makeDeferredWithPromise<T>(): {
+    deferred: Deferred<T>;
+    promise: Promise<T>;
+};

package/lib/PromiseQueue.d.ts

@@ -0,0 +1,25 @@
+import { type Deferred } from './Deferred';
+type PromiseQueueOpts = {
+    maxConcurrent: number;
+};
+export default class PromiseQueue<T> {
+    _deferred: Deferred<Array<T>> | null | undefined;
+    _maxConcurrent: number;
+    _numRunning: number;
+    _queue: Array<() => Promise<void>>;
+    _runPromise: Promise<Array<T>> | null | undefined;
+    _error: unknown;
+    _count: number;
+    _results: Array<T>;
+    _addSubscriptions: Set<() => void>;
+    constructor(opts?: PromiseQueueOpts);
+    getNumWaiting(): number;
+    add(fn: () => Promise<T>): void;
+    subscribeToAdd(fn: () => void): () => void;
+    run(): Promise<Array<T>>;
+    _next(): Promise<void>;
+    _runFn(fn: () => unknown): Promise<void>;
+    _resetState(): void;
+    _done(): void;
+}
+export {};

package/lib/TapStream.d.ts

@@ -0,0 +1,6 @@
+import { Transform } from 'stream';
+export default class TapStream extends Transform {
+    _tap: (arg1: Buffer) => unknown;
+    constructor(tap: (arg1: Buffer) => unknown, options: unknown);
+    _transform(chunk: Buffer | string, encoding: string, callback: (err?: Error | null | undefined, chunk?: Buffer | string) => unknown): void;
+}

package/lib/alternatives.d.ts

@@ -0,0 +1,3 @@
+import type { FileSystem } from '@atlaspack/types';
+export declare function findAlternativeNodeModules(fs: FileSystem, moduleName: string, dir: string): Promise<Array<string>>;
+export declare function findAlternativeFiles(fs: FileSystem, fileSpecifier: string, dir: string, projectRoot: string, leadingDotSlash?: boolean, includeDirectories?: boolean, includeExtension?: boolean): Promise<Array<string>>;

package/lib/ansi-html.d.ts

@@ -0,0 +1 @@
+export declare function ansiHtml(ansi: string): string;

package/lib/ansi-html.js

@@ -13,6 +13,8 @@ function _ansiHtmlCommunity() {
 }
 var _escapeHtml = require("./escape-html");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// @ts-expect-error ansi-html-community is not typed
+
 function ansiHtml(ansi) {
   return (0, _ansiHtmlCommunity().default)((0, _escapeHtml.escapeHTML)(ansi));
 }

package/lib/blob.d.ts

@@ -0,0 +1,4 @@
+import type { Blob } from '@atlaspack/types';
+import { Buffer } from 'buffer';
+export declare function blobToBuffer(blob: Blob): Promise<Buffer>;
+export declare function blobToString(blob: Blob): Promise<string>;

package/lib/bundle-url.d.ts

@@ -0,0 +1,4 @@
+declare function getBundleURLCached(): string;
+export declare function getBaseURL(url?: string | null): string;
+export declare const getBundleURL: typeof getBundleURLCached;
+export {};

package/lib/collection.d.ts

@@ -0,0 +1,33 @@
+export declare function unique<T>(array: Array<T>): Array<T>;
+export declare function objectSortedEntries(obj: {
+    readonly [key: string]: unknown;
+}): Array<[string, unknown]>;
+export declare function objectSortedEntriesDeep(object: {
+    readonly [key: string]: unknown;
+}): Array<[string, unknown]>;
+/**
+ * Get the difference of A and B sets
+ *
+ * This is the set of elements which are in A but not in B
+ * For example, the difference of the sets {1,2,3} and {3,4} is {1,2}
+ *
+ * @param {*} a Set A
+ * @param {*} b Set B
+ * @returns A \ B
+ */
+export declare function setDifference<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): Set<T>;
+/**
+ * Get the symmetric difference of A and B sets
+ *
+ * This is the set of elements which are in either of the sets, but not in their intersection.
+ * For example, the symmetric difference of the sets {1,2,3} and {3,4} is {1,2,4}
+ *
+ * @param {*} a Set A
+ * @param {*} b Set B
+ * @returns A Δ B
+ */
+export declare function setSymmetricDifference<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): Set<T>;
+export declare function setIntersect<T>(a: Set<T>, b: ReadonlySet<T>): void;
+export declare function setIntersectStatic<T>(a: Set<T>, b: Set<T>): Set<T>;
+export declare function setUnion<T>(a: Iterable<T>, b: Iterable<T>): Set<T>;
+export declare function setEqual<T>(a: ReadonlySet<T>, b: ReadonlySet<T>): boolean;

package/lib/config.d.ts

@@ -0,0 +1,17 @@
+import type { ConfigResult, File, FilePath } from '@atlaspack/types';
+import type { FileSystem } from '@atlaspack/fs';
+export type ConfigOutput = {
+    config: ConfigResult;
+    files: Array<File>;
+};
+export type ConfigOptions = {
+    parse?: boolean;
+    parser?: (arg1: string) => any;
+};
+export declare function resolveConfig(fs: FileSystem, filepath: FilePath, filenames: Array<FilePath>, projectRoot: FilePath): Promise<FilePath | null | undefined>;
+export declare function resolveConfigSync(fs: FileSystem, filepath: FilePath, filenames: Array<FilePath>, projectRoot: FilePath): FilePath | null | undefined;
+export declare function loadConfig(fs: FileSystem, filepath: FilePath, filenames: Array<FilePath>, projectRoot: FilePath, opts?: ConfigOptions | null): Promise<ConfigOutput | null>;
+export declare namespace loadConfig {
+    var clear: () => void;
+}
+export declare function readConfig(fs: FileSystem, configFile: FilePath, opts?: ConfigOptions | null): Promise<ConfigOutput | null>;

package/lib/config.js

@@ -50,6 +50,9 @@ function _lruCache() {
   return data;
 }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// @ts-expect-error TS7016
+
+// @ts-expect-error TS2351
 const configCache = new (_lruCache().default)({
   max: 500
 });
@@ -81,7 +84,6 @@ async function loadConfig(fs, filepath, filenames, projectRoot, opts) {
       let extname = _path().default.extname(configFile).slice(1);
       if (extname === 'js' || extname === 'cjs') {
         let output = {
-          // $FlowFixMe
           config: (0, _clone().default)(module.require(configFile)),
           files: [{
             filePath: configFile

package/lib/countLines.d.ts

@@ -0,0 +1 @@
+export default function countLines(string: string, startIndex?: number): number;

package/lib/debounce.d.ts

@@ -0,0 +1 @@
+export default function debounce<TArgs extends Array<unknown>>(fn: (...args: TArgs) => unknown, delay: number): (...args: TArgs) => void;

package/lib/debug-tools.d.ts

@@ -0,0 +1,6 @@
+type DebugTools = {
+    ['asset-file-names-in-output']: boolean;
+    ['simple-cli-reporter']: boolean;
+};
+export declare let debugTools: DebugTools;
+export {};

package/lib/debug-tools.js

@@ -14,6 +14,7 @@ exports.debugTools = void 0;
  *
  * You can enable all tools by setting `ATLASPACK_DEBUG_TOOLS=all`.
  */
+
 let debugTools = exports.debugTools = {
   'asset-file-names-in-output': false,
   'simple-cli-reporter': false

package/lib/dependency-location.d.ts

@@ -0,0 +1,14 @@
+export default function createDependencyLocation(start: {
+    line: number;
+    column: number;
+}, specifier: string, lineOffset?: number, columnOffset?: number, importWrapperLength?: number): {
+    end: {
+        column: number;
+        line: number;
+    };
+    filePath: string;
+    start: {
+        column: number;
+        line: number;
+    };
+};

package/lib/escape-html.d.ts

@@ -0,0 +1 @@
+export declare function escapeHTML(s: string): string;

package/lib/generateBuildMetrics.d.ts

@@ -0,0 +1,18 @@
+import type { FilePath, PackagedBundle } from '@atlaspack/types';
+import type { FileSystem } from '@atlaspack/fs';
+export type AssetStats = {
+    filePath: string;
+    size: number;
+    originalSize: number;
+    time: number;
+};
+export type BundleStats = {
+    filePath: string;
+    size: number;
+    time: number;
+    assets: Array<AssetStats>;
+};
+export type BuildMetrics = {
+    bundles: Array<BundleStats>;
+};
+export default function generateBuildMetrics(bundles: Array<PackagedBundle>, fs: FileSystem, projectRoot: FilePath): Promise<BuildMetrics>;

package/lib/generateCertificate.d.ts

@@ -0,0 +1,5 @@
+import type { FileSystem } from '@atlaspack/fs';
+export default function generateCertificate(fs: FileSystem, cacheDir: string, host?: string | null): Promise<{
+    cert: Buffer;
+    key: Buffer;
+}>;

package/lib/getCertificate.d.ts

@@ -0,0 +1,6 @@
+import type { HTTPSOptions } from '@atlaspack/types';
+import type { FileSystem } from '@atlaspack/fs';
+export default function getCertificate(fs: FileSystem, options: HTTPSOptions): Promise<{
+    cert: Buffer;
+    key: Buffer;
+}>;

package/lib/getExisting.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Creates an object that contains both source and minified (using the source as a fallback).
+ * e.g. builtins.min.js and builtins.js.
+ */
+export default function getExisting(minifiedPath: string, sourcePath: string): {
+    minified: string;
+    source: string;
+};

package/lib/getModuleParts.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Returns the package name and the optional subpath
+ */
+export default function getModuleParts(_name: string): [string, string | null | undefined];

package/lib/getRootDir.d.ts

@@ -0,0 +1,2 @@
+import type { FilePath } from '@atlaspack/types';
+export default function getRootDir(files: Array<FilePath>): FilePath;

package/lib/glob.d.ts

@@ -0,0 +1,10 @@
+import type { FilePath, Glob } from '@atlaspack/types';
+import type { FileSystem } from '@atlaspack/fs';
+import { FastGlobOptions } from 'fast-glob';
+import { type Options } from 'micromatch';
+export declare function isGlob(p: FilePath): any;
+export declare function isGlobMatch(filePath: FilePath, glob: Glob | Array<Glob>, opts?: Options): any;
+export declare function globMatch(values: Array<string>, glob: Glob | Array<Glob>, opts?: Options): Array<string>;
+export declare function globToRegex(glob: Glob, opts?: Options): RegExp;
+export declare function globSync(p: FilePath, fs: FileSystem, options?: FastGlobOptions<FilePath>): Array<FilePath>;
+export declare function glob(p: FilePath, fs: FileSystem, options: FastGlobOptions<FilePath>): Promise<Array<FilePath>>;

package/lib/glob.js

@@ -34,6 +34,10 @@ var _path = require("./path");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// @ts-expect-error TS7016
+
+// @ts-expect-error TS2305
+
 function isGlob(p) {
   return (0, _isGlob2().default)((0, _path.normalizeSeparators)(p));
 }
@@ -49,32 +53,34 @@ function globToRegex(glob, opts) {
   return (0, _micromatch().makeRe)(glob, opts);
 }
 function globSync(p, fs, options) {
-  // $FlowFixMe
   options = {
     ...options,
     fs: {
+      // @ts-expect-error TS7006
       statSync: p => {
         return fs.statSync(p);
       },
+      // @ts-expect-error TS7006
       lstatSync: p => {
         // Our FileSystem interface doesn't have lstat support at the moment,
         // but this is fine for our purposes since we follow symlinks by default.
         return fs.statSync(p);
       },
+      // @ts-expect-error TS7006
       readdirSync: (p, opts) => {
         return fs.readdirSync(p, opts);
       }
     }
   };
 
-  // $FlowFixMe
+  // @ts-expect-error TS2322
   return _fastGlob().default.sync((0, _path.normalizeSeparators)(p), options);
 }
 function glob(p, fs, options) {
-  // $FlowFixMe
   options = {
     ...options,
     fs: {
+      // @ts-expect-error TS7006
       stat: async (p, cb) => {
         try {
           cb(null, await fs.stat(p));
@@ -82,6 +88,7 @@ function glob(p, fs, options) {
           cb(err);
         }
       },
+      // @ts-expect-error TS7006
       lstat: async (p, cb) => {
         // Our FileSystem interface doesn't have lstat support at the moment,
         // but this is fine for our purposes since we follow symlinks by default.
@@ -91,6 +98,7 @@ function glob(p, fs, options) {
           cb(err);
         }
       },
+      // @ts-expect-error TS7006
       readdir: async (p, opts, cb) => {
         if (typeof opts === 'function') {
           cb = opts;
@@ -105,6 +113,6 @@ function glob(p, fs, options) {
     }
   };
 
-  // $FlowFixMe Added in Flow 0.121.0 upgrade in #4381
+  // @ts-expect-error TS2322
   return (0, _fastGlob().default)((0, _path.normalizeSeparators)(p), options);
 }

package/lib/hash.d.ts

@@ -0,0 +1,7 @@
+import type { Readable } from 'stream';
+import type { FileSystem } from '@atlaspack/fs';
+export declare function hashStream(stream: Readable): Promise<string>;
+export declare function hashObject(obj: {
+    readonly [key: string]: unknown;
+}): string;
+export declare function hashFile(fs: FileSystem, filePath: string): Promise<string>;

package/lib/http-server.d.ts

@@ -0,0 +1,19 @@
+import type { Server as HTTPOnlyServer, IncomingMessage as HTTPRequest, ServerResponse as HTTPResponse } from 'http';
+import type { Server as HTTPSServer } from 'https';
+import type { FilePath, HTTPSOptions } from '@atlaspack/types';
+import type { FileSystem } from '@atlaspack/fs';
+type CreateHTTPServerOpts = {
+    listener?: (arg1: HTTPRequest, arg2: HTTPResponse) => void;
+    host?: string;
+} & ({
+    https: HTTPSOptions | boolean | null | undefined;
+    inputFS: FileSystem;
+    outputFS: FileSystem;
+    cacheDir: FilePath;
+} | Record<any, any>);
+export type HTTPServer = HTTPOnlyServer | HTTPSServer;
+export declare function createHTTPServer(options: CreateHTTPServerOpts): Promise<{
+    stop: () => Promise<void>;
+    server: HTTPServer;
+}>;
+export {};

package/lib/index.d.ts

@@ -0,0 +1,48 @@
+export * from './config';
+export * from './Deferred';
+export * from './generateBuildMetrics';
+export * from './http-server';
+export * from './path';
+export * from './prettyDiagnostic';
+export * from './schema';
+export { default as countLines } from './countLines';
+export { default as generateBuildMetrics } from './generateBuildMetrics';
+export { default as generateCertificate } from './generateCertificate';
+export { default as getCertificate } from './getCertificate';
+export { default as getModuleParts } from './getModuleParts';
+export { default as getRootDir } from './getRootDir';
+export { default as isDirectoryInside } from './isDirectoryInside';
+export { default as isURL } from './is-url';
+export { default as objectHash } from './objectHash';
+export { default as prettifyTime } from './prettifyTime';
+export { default as prettyDiagnostic } from './prettyDiagnostic';
+export { default as PromiseQueue } from './PromiseQueue';
+export { default as validateSchema } from './schema';
+export { default as TapStream } from './TapStream';
+export { default as urlJoin } from './urlJoin';
+export { default as relativeUrl } from './relativeUrl';
+export { default as createDependencyLocation } from './dependency-location';
+export { default as debounce } from './debounce';
+export { default as throttle } from './throttle';
+export { default as openInBrowser } from './openInBrowser';
+export { findAlternativeNodeModules, findAlternativeFiles } from './alternatives';
+export { blobToBuffer, blobToString } from './blob';
+export { unique, objectSortedEntries, objectSortedEntriesDeep, setDifference, setSymmetricDifference, setEqual, setIntersect, setIntersectStatic, setUnion, } from './collection';
+export { resolveConfig, resolveConfigSync, loadConfig, readConfig, } from './config';
+export { debugTools } from './debug-tools';
+export { DefaultMap, DefaultWeakMap } from './DefaultMap';
+export { makeDeferredWithPromise } from './Deferred';
+export { getProgressMessage, getPackageProgressMessage, } from './progress-message';
+export { isGlob, isGlobMatch, globMatch, globSync, glob, globToRegex, } from './glob';
+export { hashStream, hashObject, hashFile } from './hash';
+export { SharedBuffer } from './shared-buffer';
+export { fuzzySearch } from './schema';
+export { createHTTPServer } from './http-server';
+export { normalizePath, normalizeSeparators, relativePath } from './path';
+export { replaceURLReferences, replaceInlineReferences, } from './replaceBundleReferences';
+export { measureStreamLength, readableFromStringOrBuffer, bufferStream, blobToStream, streamFromPromise, fallbackStream, } from './stream';
+export { relativeBundlePath } from './relativeBundlePath';
+export { ansiHtml } from './ansi-html';
+export { escapeHTML } from './escape-html';
+export { SOURCEMAP_RE, SOURCEMAP_EXTENSIONS, matchSourceMappingURL, loadSourceMapUrl, loadSourceMap, remapSourceLocation, } from './sourcemap';
+export { default as stripAnsi } from 'strip-ansi';