@spyglassmc/core 0.1.2 → 0.2.0

package/lib/service/Service.d.ts

@@ -1,43 +1,33 @@
-/// <reference types="node" />
-import EventEmitter from 'events';
 import type { TextDocument } from 'vscode-languageserver-textdocument';
-import type { FileNode } from '../node';
-import { AstNode } from '../node';
-import type { Color, ColorInfo, ColorToken, InlayHint, SignatureHelp } from '../processor';
-import { ColorPresentation } from '../processor';
-import { Range } from '../source';
-import type { SymbolUsageType } from '../symbol';
-import { Downloader } from './Downloader';
-import { FileService } from './FileService';
-import { Hover } from './Hover';
-import { Logger } from './Logger';
-import { ProfilerFactory } from './Profiler';
-import type { ProjectInitializer } from './Project';
-import { Project } from './Project';
-import { SymbolLocations } from './SymbolLocations';
+import type { FileNode } from '../node/index.js';
+import { AstNode } from '../node/index.js';
+import type { Color, ColorInfo, ColorToken, InlayHint, SignatureHelp } from '../processor/index.js';
+import { ColorPresentation } from '../processor/index.js';
+import { Range } from '../source/index.js';
+import type { SymbolUsageType } from '../symbol/index.js';
+import { Hover } from './Hover.js';
+import type { Logger } from './Logger.js';
+import { ProfilerFactory } from './Profiler.js';
+import type { ProjectOptions } from './Project.js';
+import { Project } from './Project.js';
+import { SymbolLocations } from './SymbolLocations.js';
 interface Options {
-    cacheRoot: string;
-    downloader?: Downloader;
-    fs?: FileService;
-    initializers?: readonly ProjectInitializer[];
     isDebugging?: boolean;
-    logger?: Logger;
+    logger: Logger;
     profilers?: ProfilerFactory;
-    projectPath: string;
+    project: ProjectOptions;
 }
-export declare class Service extends EventEmitter {
-    readonly downloader: Downloader;
-    readonly fs: FileService;
+export declare class Service {
     readonly isDebugging: boolean;
     readonly logger: Logger;
     readonly profilers: ProfilerFactory;
     readonly project: Project;
-    constructor({ cacheRoot, downloader, fs, initializers, isDebugging, logger, profilers, projectPath, }: Options);
+    constructor({ isDebugging, logger, profilers, project, }: Options);
     private debug;
     colorize(node: FileNode<AstNode>, doc: TextDocument, range?: Range): readonly ColorToken[];
     getColorInfo(node: FileNode<AstNode>, doc: TextDocument): ColorInfo[];
     getColorPresentation(file: FileNode<AstNode>, doc: TextDocument, range: Range, color: Color): ColorPresentation[];
-    complete(node: FileNode<AstNode>, doc: TextDocument, offset: number, triggerCharacter?: string): import("../processor").CompletionItem[];
+    complete(node: FileNode<AstNode>, doc: TextDocument, offset: number, triggerCharacter?: string): import("../processor/index.js").CompletionItem[];
     dataHackPubify(initialism: string): string;
     format(node: FileNode<AstNode>, doc: TextDocument, tabSize: number, insertSpaces: boolean): string;
     getHover(file: FileNode<AstNode>, doc: TextDocument, offset: number): Hover | undefined;

package/lib/service/Service.js

@@ -1,33 +1,28 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Service = void 0;
-const events_1 = __importDefault(require("events"));
-const node_1 = require("../node");
-const processor_1 = require("../processor");
-const source_1 = require("../source");
-const symbol_1 = require("../symbol");
-const Context_1 = require("./Context");
-const Downloader_1 = require("./Downloader");
-const FileService_1 = require("./FileService");
-const fileUtil_1 = require("./fileUtil");
-const Hover_1 = require("./Hover");
-const Logger_1 = require("./Logger");
-const Profiler_1 = require("./Profiler");
-const Project_1 = require("./Project");
-const SymbolLocations_1 = require("./SymbolLocations");
+import { AstNode } from '../node/index.js';
+import { ColorPresentation, completer, traversePreOrder } from '../processor/index.js';
+import { Range } from '../source/index.js';
+import { SymbolUsageTypes } from '../symbol/index.js';
+import { ColorizerContext, CompleterContext, FormatterContext, ProcessorContext, SignatureHelpProviderContext } from './Context.js';
+import { fileUtil } from './fileUtil.js';
+import { Hover } from './Hover.js';
+import { ProfilerFactory } from './Profiler.js';
+import { Project } from './Project.js';
+import { SymbolLocations } from './SymbolLocations.js';
 /* istanbul ignore next */
-class Service extends events_1.default {
-    constructor({ cacheRoot, downloader, fs = FileService_1.FileService.create(cacheRoot), initializers = [], isDebugging = false, logger = Logger_1.Logger.create(), profilers = Profiler_1.ProfilerFactory.noop(), projectPath, }) {
-        super();
-        this.downloader = (downloader ?? (downloader = new Downloader_1.Downloader(cacheRoot, logger)));
-        this.fs = fs;
+export class Service {
+    isDebugging;
+    logger;
+    profilers;
+    project;
+    constructor({ isDebugging = false, logger, profilers = ProfilerFactory.noop(), project, }) {
         this.isDebugging = isDebugging;
         this.logger = logger;
         this.profilers = profilers;
-        this.project = new Project_1.Project({ cacheRoot, downloader, fs, initializers, logger, profilers, projectPath });
+        this.project = new Project({
+            logger,
+            profilers,
+            ...project,
+        });
     }
     debug(message) {
         if (this.isDebugging) {
@@ -38,7 +33,7 @@ class Service extends events_1.default {
         try {
             this.debug(`Colorizing '${doc.uri}' # ${doc.version}`);
             const colorizer = this.project.meta.getColorizer(node.type);
-            return colorizer(node, Context_1.ColorizerContext.create(this.project, { doc, range }));
+            return colorizer(node, ColorizerContext.create(this.project, { doc, range }));
         }
         catch (e) {
             this.logger.error(`[Service] [colorize] Failed for “${doc.uri}” #${doc.version}`, e);
@@ -49,7 +44,7 @@ class Service extends events_1.default {
         try {
             this.debug(`Getting color info for '${doc.uri}' # ${doc.version}`);
             const ans = [];
-            (0, processor_1.traversePreOrder)(node, _ => true, node => node.color, node => ans.push({
+            traversePreOrder(node, _ => true, node => node.color, node => ans.push({
                 color: Array.isArray(node.color) ? node.color : node.color.value,
                 range: Array.isArray(node.color) ? node.range : (node.color.range ?? node.range),
             }));
@@ -62,13 +57,13 @@ class Service extends events_1.default {
     }
     getColorPresentation(file, doc, range, color) {
         try {
-            this.debug(`Getting color presentation for '${doc.uri}' # ${doc.version} @ ${source_1.Range.toString(range)}`);
-            let node = node_1.AstNode.findDeepestChild({ node: file, needle: range.start });
+            this.debug(`Getting color presentation for '${doc.uri}' # ${doc.version} @ ${Range.toString(range)}`);
+            let node = AstNode.findDeepestChild({ node: file, needle: range.start });
             while (node) {
                 const nodeColor = node.color;
                 if (nodeColor && !Array.isArray(nodeColor)) {
                     const colorRange = nodeColor.range ?? node.range;
-                    return nodeColor.format.map(format => processor_1.ColorPresentation.fromColorFormat(format, color, colorRange));
+                    return nodeColor.format.map(format => ColorPresentation.fromColorFormat(format, color, colorRange));
                 }
                 node = node.parent;
             }
@@ -83,7 +78,7 @@ class Service extends events_1.default {
             this.debug(`Getting completion for '${doc.uri}' # ${doc.version} @ ${offset}`);
             const shouldComplete = this.project.meta.shouldComplete(doc.languageId, triggerCharacter);
             if (shouldComplete) {
-                return processor_1.completer.file(node, Context_1.CompleterContext.create(this.project, { doc, offset, triggerCharacter }));
+                return completer.file(node, CompleterContext.create(this.project, { doc, offset, triggerCharacter }));
             }
         }
         catch (e) {
@@ -112,7 +107,7 @@ class Service extends events_1.default {
         try {
             this.debug(`Formatting '${doc.uri}' # ${doc.version}`);
             const formatter = this.project.meta.getFormatter(node.type);
-            return formatter(node, Context_1.FormatterContext.create(this.project, { doc, tabSize, insertSpaces }));
+            return formatter(node, FormatterContext.create(this.project, { doc, tabSize, insertSpaces }));
         }
         catch (e) {
             this.logger.error(`[Service] [format] Failed for “${doc.uri}” #${doc.version}`, e);
@@ -122,15 +117,15 @@ class Service extends events_1.default {
     getHover(file, doc, offset) {
         try {
             this.debug(`Getting hover for '${doc.uri}' # ${doc.version} @ ${offset}`);
-            let node = node_1.AstNode.findDeepestChild({ node: file, needle: offset });
+            let node = AstNode.findDeepestChild({ node: file, needle: offset });
             while (node) {
                 const symbol = this.project.symbols.resolveAlias(node.symbol);
                 if (symbol) {
                     const hover = `\`\`\`typescript\n(${symbol.category}${symbol.subcategory ? `/${symbol.subcategory}` : ''}) ${symbol.identifier}\n\`\`\`` + (symbol.desc ? `\n******\n${symbol.desc}` : '');
-                    return Hover_1.Hover.create(node.range, hover);
+                    return Hover.create(node.range, hover);
                 }
                 if (node.hover) {
-                    return Hover_1.Hover.create(node.range, node.hover);
+                    return Hover.create(node.range, node.hover);
                 }
                 node = node.parent;
             }
@@ -145,7 +140,7 @@ class Service extends events_1.default {
             // TODO: `range` argument is not used.
             this.debug(`Getting inlay hints for '${doc.uri}' # ${doc.version}`);
             const ans = [];
-            const ctx = Context_1.ProcessorContext.create(this.project, { doc });
+            const ctx = ProcessorContext.create(this.project, { doc });
             for (const provider of this.project.meta.inlayHintProviders) {
                 ans.push(...provider(node, ctx));
             }
@@ -159,7 +154,7 @@ class Service extends events_1.default {
     getSignatureHelp(node, doc, offset) {
         try {
             this.debug(`Getting signature help for '${doc.uri}' # ${doc.version} @ ${offset}`);
-            const ctx = Context_1.SignatureHelpProviderContext.create(this.project, { doc, offset });
+            const ctx = SignatureHelpProviderContext.create(this.project, { doc, offset });
             for (const provider of this.project.meta.signatureHelpProviders) {
                 const result = provider(node, ctx);
                 if (result) {
@@ -178,10 +173,10 @@ class Service extends events_1.default {
      *
      * @returns Symbol locations of the selected symbol at `offset`, or `undefined` if there's no symbol at `offset`.
      */
-    async getSymbolLocations(file, doc, offset, searchedUsages = symbol_1.SymbolUsageTypes, currentFileOnly = false) {
+    async getSymbolLocations(file, doc, offset, searchedUsages = SymbolUsageTypes, currentFileOnly = false) {
         try {
             this.debug(`Getting symbol locations of usage '${searchedUsages.join(',')}' for '${doc.uri}' # ${doc.version} @ ${offset} with currentFileOnly=${currentFileOnly}`);
-            let node = node_1.AstNode.findDeepestChild({ node: file, needle: offset });
+            let node = AstNode.findDeepestChild({ node: file, needle: offset });
             while (node) {
                 const symbol = this.project.symbols.resolveAlias(node.symbol);
                 if (symbol) {
@@ -195,14 +190,14 @@ class Service extends events_1.default {
                     }
                     const locations = [];
                     for (const loc of rawLocations) {
-                        const mappedUri = fileUtil_1.fileUtil.isFileUri(loc.uri)
+                        const mappedUri = fileUtil.isFileUri(loc.uri)
                             ? loc.uri
                             : await this.project.fs.mapToDisk(loc.uri);
                         if (mappedUri) {
                             locations.push({ ...loc, uri: mappedUri });
                         }
                     }
-                    return SymbolLocations_1.SymbolLocations.create(node.range, locations.length ? locations : undefined);
+                    return SymbolLocations.create(node.range, locations.length ? locations : undefined);
                 }
                 node = node.parent;
             }
@@ -213,5 +208,4 @@ class Service extends events_1.default {
         return undefined;
     }
 }
-exports.Service = Service;
 //# sourceMappingURL=Service.js.map

package/lib/service/SymbolLocations.d.ts

@@ -1,6 +1,6 @@
-import type { RangeLike } from '../source';
-import { Range } from '../source';
-import type { SymbolLocation } from '../symbol';
+import type { RangeLike } from '../source/index.js';
+import { Range } from '../source/index.js';
+import type { SymbolLocation } from '../symbol/index.js';
 export interface SymbolLocations {
     /**
      * The range of the currently selected symbol.

package/lib/service/SymbolLocations.js

@@ -1,16 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SymbolLocations = void 0;
-const source_1 = require("../source");
-var SymbolLocations;
+import { Range } from '../source/index.js';
+export var SymbolLocations;
 (function (SymbolLocations) {
     /* istanbul ignore next */
     function create(range, locations) {
         return {
-            range: source_1.Range.get(range),
+            range: Range.get(range),
             locations,
         };
     }
     SymbolLocations.create = create;
-})(SymbolLocations = exports.SymbolLocations || (exports.SymbolLocations = {}));
+})(SymbolLocations || (SymbolLocations = {}));
 //# sourceMappingURL=SymbolLocations.js.map

package/lib/service/SymbolRegistrar.d.ts

@@ -1,4 +1,4 @@
-import type { SymbolUtil } from '../symbol';
+import type { SymbolUtil } from '../symbol/index.js';
 export declare type SymbolRegistrar = (this: void, symbols: SymbolUtil, ctx: SymbolRegistrarContext) => void;
 export interface SymbolRegistrarContext {
 }

package/lib/service/SymbolRegistrar.js

@@ -1,3 +1,2 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=SymbolRegistrar.js.map

package/lib/service/fileUtil.d.ts

@@ -1,12 +1,6 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import { URL as Uri } from 'url';
+import type { Externals, FsLocation } from '../common/index.js';
 export declare type RootUriString = `${string}/`;
 export declare type FileExtension = `.${string}`;
-/**
- * A string file path, string file URI, or a file URI object.
- */
-export declare type PathLike = string | Uri;
 export declare namespace fileUtil {
     /**
      * @param rootUris The root URIs. Each URI in this array must end with a slash (`/`).
@@ -45,25 +39,13 @@ export declare namespace fileUtil {
      * @returns The part from the last `/` to the end of the URI.
      */
     function basename(uri: string): string;
-    /**
-     * @param fileUri A file URI.
-     * @returns The corresponding file path of the `fileUri` in platform-specific format.
-     * @throws If the URI is not a file schema URI.
-     */
-    function fileUriToPath(fileUri: string): string;
-    /**
-     * @param path A file path.
-     * @returns The corresponding file URI of the `path`.
-     */
-    function pathToFileUri(path: string): string;
-    function normalize(uri: string): string;
-    function getParentOfFile(path: PathLike): PathLike;
+    function getParentOfFile(externals: Externals, path: FsLocation): FsLocation;
     /**
      * @throws
      *
      * @param mode Default to `0o777` (`rwxrwxrwx`)
      */
-    function ensureDir(path: PathLike, mode?: number): Promise<void>;
+    function ensureDir(externals: Externals, path: FsLocation, mode?: number): Promise<void>;
     /**
      * @throws
      *
@@ -71,11 +53,11 @@ export declare namespace fileUtil {
      *
      * @param mode Default to `0o777` (`rwxrwxrwx`)
      */
-    function ensureParentOfFile(path: PathLike, mode?: number): Promise<void>;
-    function chmod(path: PathLike, mode: number): Promise<void>;
-    function ensureWritable(path: PathLike): Promise<void>;
-    function markReadOnly(path: PathLike): Promise<void>;
-    function readFile(path: PathLike): Promise<Buffer>;
+    function ensureParentOfFile(externals: Externals, path: FsLocation, mode?: number): Promise<void>;
+    function chmod(externals: Externals, path: FsLocation, mode: number): Promise<void>;
+    function ensureWritable(externals: Externals, path: FsLocation): Promise<void>;
+    function markReadOnly(externals: Externals, path: FsLocation): Promise<void>;
+    function readFile(externals: Externals, path: FsLocation): Promise<Uint8Array>;
     /**
      * @throws
      *
@@ -88,44 +70,32 @@ export declare namespace fileUtil {
      * * Mode: `0o666` (`rw-rw-rw-`)
      * * Flag: `w`
      */
-    function writeFile(path: PathLike, data: Buffer | string, mode?: number): Promise<void>;
+    function writeFile(externals: Externals, path: FsLocation, data: Uint8Array | string, mode?: number): Promise<void>;
     /**
      * @throws
      */
-    function readJson<T = any>(path: PathLike): Promise<T>;
+    function readJson(externals: Externals, path: FsLocation): Promise<unknown>;
     /**
      * @throws
      *
      * @see {@link writeFile}
      */
-    function writeJson(path: PathLike, data: any): Promise<void>;
+    function writeJson(externals: Externals, path: FsLocation, data: any): Promise<void>;
     /**
      * @throws
      */
-    function readGzippedFile(path: PathLike): Promise<Buffer>;
+    function readGzippedFile(externals: Externals, path: FsLocation): Promise<Uint8Array>;
     /**
      * @throws
      */
-    function writeGzippedFile(path: PathLike, buffer: Buffer | string): Promise<void>;
+    function writeGzippedFile(externals: Externals, path: FsLocation, buffer: Uint8Array | string): Promise<void>;
     /**
      * @throws
      */
-    function readGzippedJson<T = any>(path: PathLike): Promise<T>;
+    function readGzippedJson(externals: Externals, path: FsLocation): Promise<unknown>;
     /**
      * @throws
      */
-    function writeGzippedJson(path: PathLike, data: any): Promise<void>;
-    /**
-     * Show the file/directory in the platform-specific explorer program.
-     *
-     * Should not be called with unsanitized user-input path due to the possibility of
-     * arbitrary code execution.
-     *
-     * @returns The `stdout` from the spawned child process.
-     */
-    function showFile(path: string): Promise<{
-        stdout: string;
-        stderr: string;
-    }>;
+    function writeGzippedJson(externals: Externals, path: FsLocation, data: any): Promise<void>;
 }
 //# sourceMappingURL=fileUtil.d.ts.map

package/lib/service/fileUtil.js

@@ -1,41 +1,5 @@
-"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.fileUtil = void 0;
-const child_process_1 = __importDefault(require("child_process"));
-const fs_1 = require("fs");
-const path_1 = require("path");
-const process_1 = __importDefault(require("process"));
-const url_1 = __importStar(require("url"));
-const util_1 = require("util");
-const zlib_1 = __importDefault(require("zlib"));
-const common_1 = require("../common");
-var fileUtil;
+import { bufferToString, Uri } from '../common/index.js';
+export var fileUtil;
 (function (fileUtil) {
     /**
      * @param rootUris The root URIs. Each URI in this array must end with a slash (`/`).
@@ -106,53 +70,8 @@ var fileUtil;
     }
     fileUtil.basename = basename;
     /* istanbul ignore next */
-    /**
-     * @param fileUri A file URI.
-     * @returns The corresponding file path of the `fileUri` in platform-specific format.
-     * @throws If the URI is not a file schema URI.
-     */
-    function fileUriToPath(fileUri) {
-        return url_1.default.fileURLToPath(new url_1.URL(fileUri));
-    }
-    fileUtil.fileUriToPath = fileUriToPath;
-    /* istanbul ignore next */
-    /**
-     * @param path A file path.
-     * @returns The corresponding file URI of the `path`.
-     */
-    function pathToFileUri(path) {
-        return url_1.default.pathToFileURL(path).toString();
-    }
-    fileUtil.pathToFileUri = pathToFileUri;
-    /* istanbul ignore next */
-    function normalize(uri) {
-        try {
-            return isFileUri(uri) ? pathToFileUri(fileUriToPath(uri)) : new url_1.URL(uri).toString();
-        }
-        catch {
-            return uri;
-        }
-    }
-    fileUtil.normalize = normalize;
-    /**
-     * @param path A string file path, string file URI, or a file URI object.
-     *
-     * @returns A {@link fs.PathLike}.
-     */
-    function toFsPathLike(path) {
-        if (typeof path === 'string' && isFileUri(path)) {
-            return new url_1.URL(path);
-        }
-        return path;
-    }
-    /* istanbul ignore next */
-    function getParentOfFile(path) {
-        if (path instanceof url_1.URL || isFileUri(path)) {
-            return new url_1.URL('.', path);
-        }
-        else {
-            return (0, path_1.resolve)(path, '..');
-        }
+    function getParentOfFile(externals, path) {
+        return new Uri('.', path);
     }
     fileUtil.getParentOfFile = getParentOfFile;
     /* istanbul ignore next */
@@ -161,12 +80,12 @@ var fileUtil;
      *
      * @param mode Default to `0o777` (`rwxrwxrwx`)
      */
-    async function ensureDir(path, mode = 0o777) {
+    async function ensureDir(externals, path, mode = 0o777) {
         try {
-            await fs_1.promises.mkdir(toFsPathLike(path), { mode, recursive: true });
+            await externals.fs.mkdir(path, { mode, recursive: true });
         }
         catch (e) {
-            if (!(0, common_1.isErrorCode)(e, 'EEXIST')) {
+            if (!externals.error.isKind(e, 'EEXIST')) {
                 throw e;
             }
         }
@@ -180,31 +99,31 @@ var fileUtil;
      *
      * @param mode Default to `0o777` (`rwxrwxrwx`)
      */
-    async function ensureParentOfFile(path, mode = 0o777) {
-        return ensureDir(getParentOfFile(path), mode);
+    async function ensureParentOfFile(externals, path, mode = 0o777) {
+        return ensureDir(externals, getParentOfFile(externals, path), mode);
     }
     fileUtil.ensureParentOfFile = ensureParentOfFile;
-    async function chmod(path, mode) {
-        return fs_1.promises.chmod(toFsPathLike(path), mode);
+    async function chmod(externals, path, mode) {
+        return externals.fs.chmod(path, mode);
     }
     fileUtil.chmod = chmod;
-    async function ensureWritable(path) {
+    async function ensureWritable(externals, path) {
         try {
-            await chmod(path, 0o666);
+            await chmod(externals, path, 0o666);
         }
         catch (e) {
-            if (!(0, common_1.isEnoent)(e)) {
+            if (!externals.error.isKind(e, 'ENOENT')) {
                 throw e;
             }
         }
     }
     fileUtil.ensureWritable = ensureWritable;
-    async function markReadOnly(path) {
-        return chmod(path, 0o444);
+    async function markReadOnly(externals, path) {
+        return chmod(externals, path, 0o444);
     }
     fileUtil.markReadOnly = markReadOnly;
-    async function readFile(path) {
-        return fs_1.promises.readFile(toFsPathLike(path));
+    async function readFile(externals, path) {
+        return externals.fs.readFile(path);
     }
     fileUtil.readFile = readFile;
     /* istanbul ignore next */
@@ -220,18 +139,18 @@ var fileUtil;
      * * Mode: `0o666` (`rw-rw-rw-`)
      * * Flag: `w`
      */
-    async function writeFile(path, data, mode = 0o666) {
-        await ensureParentOfFile(path);
-        await ensureWritable(path);
-        return fs_1.promises.writeFile(toFsPathLike(path), data, { mode });
+    async function writeFile(externals, path, data, mode = 0o666) {
+        await ensureParentOfFile(externals, path);
+        await ensureWritable(externals, path);
+        return externals.fs.writeFile(path, data, { mode });
     }
     fileUtil.writeFile = writeFile;
     /* istanbul ignore next */
     /**
      * @throws
      */
-    async function readJson(path) {
-        return JSON.parse((0, common_1.bufferToString)(await readFile(path)));
+    async function readJson(externals, path) {
+        return JSON.parse(bufferToString(await readFile(externals, path)));
     }
     fileUtil.readJson = readJson;
     /* istanbul ignore next */
@@ -240,64 +159,40 @@ var fileUtil;
      *
      * @see {@link writeFile}
      */
-    async function writeJson(path, data) {
-        return writeFile(path, JSON.stringify(data));
+    async function writeJson(externals, path, data) {
+        return writeFile(externals, path, JSON.stringify(data));
     }
     fileUtil.writeJson = writeJson;
     /**
      * @throws
      */
-    async function readGzippedFile(path) {
-        const unzip = (0, util_1.promisify)(zlib_1.default.gunzip);
-        return unzip(await readFile(path));
+    async function readGzippedFile(externals, path) {
+        return externals.archive.gunzip(await readFile(externals, path));
     }
     fileUtil.readGzippedFile = readGzippedFile;
     /**
      * @throws
      */
-    async function writeGzippedFile(path, buffer) {
-        const zip = (0, util_1.promisify)(zlib_1.default.gzip);
-        return writeFile(path, await zip(buffer));
+    async function writeGzippedFile(externals, path, buffer) {
+        if (typeof buffer === 'string') {
+            buffer = new TextEncoder().encode(buffer);
+        }
+        return writeFile(externals, path, await externals.archive.gzip(buffer));
     }
     fileUtil.writeGzippedFile = writeGzippedFile;
     /**
      * @throws
      */
-    async function readGzippedJson(path) {
-        return JSON.parse((0, common_1.bufferToString)(await readGzippedFile(path)));
+    async function readGzippedJson(externals, path) {
+        return JSON.parse(bufferToString(await readGzippedFile(externals, path)));
     }
     fileUtil.readGzippedJson = readGzippedJson;
     /**
      * @throws
      */
-    async function writeGzippedJson(path, data) {
-        return writeGzippedFile(path, JSON.stringify(data));
+    async function writeGzippedJson(externals, path, data) {
+        return writeGzippedFile(externals, path, JSON.stringify(data));
     }
     fileUtil.writeGzippedJson = writeGzippedJson;
-    /**
-     * Show the file/directory in the platform-specific explorer program.
-     *
-     * Should not be called with unsanitized user-input path due to the possibility of
-     * arbitrary code execution.
-     *
-     * @returns The `stdout` from the spawned child process.
-     */
-    async function showFile(path) {
-        const execFile = (0, util_1.promisify)(child_process_1.default.execFile);
-        let command;
-        switch (process_1.default.platform) {
-            case 'darwin':
-                command = 'open';
-                break;
-            case 'win32':
-                command = 'explorer';
-                break;
-            default:
-                command = 'xdg-open';
-                break;
-        }
-        return execFile(command, [path]);
-    }
-    fileUtil.showFile = showFile;
-})(fileUtil = exports.fileUtil || (exports.fileUtil = {}));
+})(fileUtil || (fileUtil = {}));
 //# sourceMappingURL=fileUtil.js.map