typescript 7.0.1-rc → 7.1.0-beta

package/dist/api/diagnosticFormatter.js

@@ -0,0 +1,169 @@
+import { convertToRelativePath } from "./path.js";
+const foregroundColorEscapeGrey = "\x1b[90m";
+const foregroundColorEscapeRed = "\x1b[91m";
+const foregroundColorEscapeYellow = "\x1b[93m";
+const foregroundColorEscapeBlue = "\x1b[94m";
+const foregroundColorEscapeCyan = "\x1b[96m";
+const gutterStyleSequence = "\x1b[7m";
+const gutterSeparator = " ";
+const resetEscapeSequence = "\x1b[0m";
+const ellipsis = "...";
+const halfIndent = "  ";
+const indent = "    ";
+const fileAppearsToBeBinaryCode = 1490;
+function diagnosticCategoryName(category) {
+    switch (category) {
+        case 0:
+            return "warning";
+        case 1:
+            return "error";
+        case 2:
+            return "suggestion";
+        case 3:
+            return "message";
+        default:
+            throw new Error(`Unknown diagnostic category: ${category}`);
+    }
+}
+function getCategoryFormat(category) {
+    switch (category) {
+        case 0:
+            return foregroundColorEscapeYellow;
+        case 1:
+            return foregroundColorEscapeRed;
+        case 2:
+            return foregroundColorEscapeGrey;
+        case 3:
+            return foregroundColorEscapeBlue;
+        default:
+            throw new Error(`Unknown diagnostic category: ${category}`);
+    }
+}
+function formatColorAndReset(text, formatStyle) {
+    return formatStyle + text + resetEscapeSequence;
+}
+function diagnosticPrefix(diagnostic) {
+    return diagnostic.source || "TS";
+}
+function flattenDiagnosticMessage(diagnostic, newLine, indentLevel = 0) {
+    let result = "";
+    if (indentLevel) {
+        result += newLine + "  ".repeat(indentLevel);
+    }
+    result += diagnostic.text;
+    for (const child of diagnostic.messageChain ?? []) {
+        result += flattenDiagnosticMessage(child, newLine, indentLevel + 1);
+    }
+    return result;
+}
+function relativeFileName(fileName, host) {
+    return convertToRelativePath(fileName, host.getCurrentDirectory(), name => host.getCanonicalFileName(name));
+}
+function formatLocation(diagnostic, host) {
+    if (!diagnostic.fileName || !diagnostic.startPosition)
+        return "";
+    const fileName = relativeFileName(diagnostic.fileName, host);
+    const { line, character } = diagnostic.startPosition;
+    return formatColorAndReset(fileName, foregroundColorEscapeCyan) +
+        ":" +
+        formatColorAndReset(`${line + 1}`, foregroundColorEscapeYellow) +
+        ":" +
+        formatColorAndReset(`${character + 1}`, foregroundColorEscapeYellow);
+}
+function formatCodeSpan(diagnostic, lineIndent, squiggleColor, host) {
+    const { startPosition, endPosition, sourceLines } = diagnostic;
+    if (!startPosition || !endPosition || !sourceLines?.length)
+        return "";
+    const endCharacter = startPosition.line === endPosition.line &&
+        startPosition.character === endPosition.character
+        ? endPosition.character + 1
+        : endPosition.character;
+    const hasMoreThanFiveLines = endPosition.line - startPosition.line >= 4;
+    const gutterWidth = hasMoreThanFiveLines
+        ? Math.max(ellipsis.length, `${endPosition.line + 1}`.length)
+        : `${endPosition.line + 1}`.length;
+    let context = "";
+    let previousLine;
+    for (const sourceLine of sourceLines) {
+        if (previousLine !== undefined && sourceLine.line > previousLine + 1) {
+            context += host.getNewLine();
+            context += lineIndent +
+                formatColorAndReset(ellipsis.padStart(gutterWidth), gutterStyleSequence) +
+                gutterSeparator;
+        }
+        const lineContent = sourceLine.text.trimEnd().replace(/\t/g, " ");
+        context += host.getNewLine();
+        context += lineIndent +
+            formatColorAndReset(`${sourceLine.line + 1}`.padStart(gutterWidth), gutterStyleSequence) +
+            gutterSeparator +
+            lineContent +
+            host.getNewLine();
+        context += lineIndent +
+            formatColorAndReset("".padStart(gutterWidth), gutterStyleSequence) +
+            gutterSeparator +
+            squiggleColor;
+        if (sourceLine.line === startPosition.line) {
+            const lastCharacter = sourceLine.line === endPosition.line
+                ? endCharacter
+                : lineContent.length;
+            context += " ".repeat(startPosition.character);
+            context += "~".repeat(Math.max(0, lastCharacter - startPosition.character));
+        }
+        else if (sourceLine.line === endPosition.line) {
+            context += "~".repeat(endCharacter);
+        }
+        else {
+            context += "~".repeat(lineContent.length);
+        }
+        context += resetEscapeSequence;
+        previousLine = sourceLine.line;
+    }
+    return context;
+}
+export function formatDiagnostics(diagnostics, host) {
+    let output = "";
+    for (const diagnostic of diagnostics) {
+        const errorMessage = `${diagnosticCategoryName(diagnostic.category)} ${diagnosticPrefix(diagnostic)}${diagnostic.code}: ${flattenDiagnosticMessage(diagnostic, host.getNewLine())}${host.getNewLine()}`;
+        if (diagnostic.fileName && diagnostic.startPosition) {
+            const { line, character } = diagnostic.startPosition;
+            output += `${relativeFileName(diagnostic.fileName, host)}(${line + 1},${character + 1}): ${errorMessage}`;
+        }
+        else {
+            output += errorMessage;
+        }
+    }
+    return output;
+}
+export function formatDiagnosticsWithColorAndContext(diagnostics, host) {
+    let output = "";
+    for (let i = 0; i < diagnostics.length; i++) {
+        if (i > 0) {
+            output += host.getNewLine();
+        }
+        const diagnostic = diagnostics[i];
+        if (diagnostic.fileName && diagnostic.startPosition) {
+            output += formatLocation(diagnostic, host) + " - ";
+        }
+        output += formatColorAndReset(diagnosticCategoryName(diagnostic.category), getCategoryFormat(diagnostic.category));
+        output += formatColorAndReset(` ${diagnosticPrefix(diagnostic)}${diagnostic.code}: `, foregroundColorEscapeGrey);
+        output += flattenDiagnosticMessage(diagnostic, host.getNewLine());
+        if (diagnostic.fileName && diagnostic.code !== fileAppearsToBeBinaryCode) {
+            output += host.getNewLine();
+            output += formatCodeSpan(diagnostic, "", getCategoryFormat(diagnostic.category), host);
+            output += host.getNewLine();
+        }
+        if (diagnostic.relatedInformation?.length) {
+            for (const related of diagnostic.relatedInformation) {
+                if (related.fileName && related.startPosition) {
+                    output += host.getNewLine();
+                    output += halfIndent + formatLocation(related, host);
+                    output += " - " + flattenDiagnosticMessage(related, host.getNewLine());
+                    output += formatCodeSpan(related, indent, foregroundColorEscapeCyan, host);
+                }
+                output += host.getNewLine();
+            }
+        }
+    }
+    return output;
+}
+//# sourceMappingURL=diagnosticFormatter.js.map

package/dist/api/diagnosticFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnosticFormatter.js","sourceRoot":"","sources":["../../src/api/diagnosticFormatter.ts"],"names":[],"mappings":"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"}

package/dist/api/fs.d.ts

@@ -1,23 +1,78 @@
+import type { RootedDirectoryPath, RootedFilePath, RootedPath } from "../ast/index.ts";
+import type { RequestDirectoryEntries, RequestFileSystem, RequestSymlink } from "./proto.generated.ts";
+import { type DocumentIdentifier } from "./proto.ts";
 export interface FileSystemEntries {
     files: string[];
     directories: string[];
+    /** Names from `files` or `directories` that are symbolic links. */
+    symlinks: string[] | undefined;
 }
-export interface FileSystem {
-    directoryExists?: (directoryName: string) => boolean | undefined;
-    fileExists?: (fileName: string) => boolean | undefined;
-    getAccessibleEntries?: (directoryName: string) => FileSystemEntries | undefined;
+export interface FileSystemStat {
+    /** POSIX-style file mode, matching Node.js `fs.Stats.mode`. */
+    mode: number;
+    /** File size in bytes, matching Node.js `fs.Stats.size`. */
+    size: number;
+    /** Last modification time, matching Node.js `fs.Stats.mtime`. */
+    mtime: Date;
+}
+declare const useOS: unique symbol;
+declare const identity: unique symbol;
+declare const fakeStat: unique symbol;
+declare const noop: unique symbol;
+declare const error: unique symbol;
+export declare const serverFS: {
+    /** Delegate the configured operation, or the current callback invocation, to the server's operating-system filesystem. */
+    readonly useOS: typeof useOS;
+    /** Use the input path as its own real path without consulting a filesystem. Valid only for `realpath`. */
+    readonly identity: typeof identity;
+    /** Synthesize stat information from `directoryExists` and `fileExists`. Valid only for `stat`. */
+    readonly fakeStat: typeof fakeStat;
+    /** Ignore writes without invoking a callback or writing to the server's operating-system filesystem. Valid only for `writeFile`. */
+    readonly noop: typeof noop;
+    /** Panic if the configured operation, or current callback invocation, reaches the server filesystem. */
+    readonly error: typeof error;
+};
+export interface FileSystemCallbacks {
+    directoryExists: ((directoryName: RootedDirectoryPath) => boolean | typeof serverFS.useOS | typeof serverFS.error) | typeof serverFS.useOS | typeof serverFS.error;
+    fileExists: ((fileName: RootedFilePath) => boolean | typeof serverFS.useOS | typeof serverFS.error) | typeof serverFS.useOS | typeof serverFS.error;
+    getAccessibleEntries: ((directoryName: RootedDirectoryPath) => FileSystemEntries | typeof serverFS.useOS | typeof serverFS.error) | typeof serverFS.useOS | typeof serverFS.error;
     /**
      * Read a file's content.
      * - Return the file content as a `string` (including `""` for empty files).
-     * - Return `null` to indicate the file does not exist (without falling back to the real FS).
-     * - Return `undefined` to fall back to the real filesystem.
+     * - Return `undefined` to indicate the file does not exist.
+     * - Return {@link serverFS.useOS} to fall back to the server's operating-system filesystem.
      */
-    readFile?: (fileName: string) => string | null | undefined;
-    realpath?: (path: string) => string | undefined;
-    writeFile?: (path: string, content: string) => void;
-    removeFile?: (path: string) => void;
+    readFile: ((fileName: RootedFilePath) => string | undefined | typeof serverFS.useOS | typeof serverFS.error) | typeof serverFS.useOS | typeof serverFS.error;
+    /** Relative results are resolved against the queried path's directory by the server. */
+    realpath: ((path: RootedPath) => string | typeof serverFS.useOS | typeof serverFS.identity | typeof serverFS.error) | typeof serverFS.useOS | typeof serverFS.identity | typeof serverFS.error;
+    stat: ((path: RootedPath) => FileSystemStat | undefined | typeof serverFS.useOS | typeof serverFS.fakeStat | typeof serverFS.error) | typeof serverFS.useOS | typeof serverFS.fakeStat | typeof serverFS.error;
+    writeFile: ((path: RootedFilePath, content: string) => void | typeof serverFS.useOS | typeof serverFS.noop | typeof serverFS.error) | typeof serverFS.useOS | typeof serverFS.noop | typeof serverFS.error;
+    removeFile: ((path: RootedPath) => void | typeof serverFS.useOS | typeof serverFS.noop | typeof serverFS.error) | typeof serverFS.useOS | typeof serverFS.noop | typeof serverFS.error;
+}
+export interface CreateFileSystemOptions {
+    /** Complete directory listings. Full filesystems derive these from `files` when omitted. */
+    directories?: Record<string, RequestDirectoryEntries> | undefined;
+    symlinks?: Record<string, RequestSymlink> | undefined;
+    /** Files or directory trees hidden from an underlying snapshot or host filesystem. */
+    removedPaths?: readonly string[] | undefined;
+}
+export interface CreateFileSystemWithLibOptions extends CreateFileSystemOptions {
+    /** Default library directory used by a custom or non-embedded compiler executable. */
+    defaultLibraryPath?: string | undefined;
 }
-/** The callback names supported by the Go server for virtual FS delegation. */
-export declare const fsCallbackNames: readonly ["readFile", "fileExists", "directoryExists", "getAccessibleEntries", "realpath"];
-export declare function createVirtualFileSystem(files: Record<string, string>): FileSystem;
+/**
+ * Files supplied to a request filesystem. String identifiers are file names;
+ * use `{ uri }` when supplying a document URI so it can be decoded correctly.
+ */
+export type RequestFileEntries = readonly (readonly [id: DocumentIdentifier, content: string])[];
+/** Creates a full request filesystem. The server derives directory listings when omitted. */
+export declare function createFileSystem(files: RequestFileEntries, options?: CreateFileSystemOptions): RequestFileSystem;
+/**
+ * Creates a full request filesystem with the compiler's default library
+ * directory mounted read-only through the host filesystem.
+ */
+export declare function createFileSystemWithLib(files: RequestFileEntries, options?: CreateFileSystemWithLibOptions): RequestFileSystem;
+/** Creates a request filesystem layer, merging base directory listings when omitted. */
+export declare function createFileSystemLayer(files: RequestFileEntries, options?: CreateFileSystemOptions): RequestFileSystem;
+export {};
 //# sourceMappingURL=fs.d.ts.map

package/dist/api/fs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/api/fs.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACvB,eAAe,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IACjE,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IACvD,oBAAoB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,iBAAiB,GAAG,SAAS,CAAC;IAChF;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,4FAA6F,CAAC;AAa1H,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,CAkHjF"}
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/api/fs.ts"],"names":[],"mappings":"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"}

package/dist/api/fs.js

@@ -1,109 +1,70 @@
-import { getPathComponents } from "./path.js";
-/** The callback names supported by the Go server for virtual FS delegation. */
-export const fsCallbackNames = ["readFile", "fileExists", "directoryExists", "getAccessibleEntries", "realpath"];
-export function createVirtualFileSystem(files) {
-    const root = {
-        type: "directory",
-        children: {},
-    };
-    const content = {};
-    for (const filePath of Object.keys(files)) {
-        content[filePath] = files[filePath];
-        addToTree(filePath);
-    }
-    return {
-        directoryExists,
-        fileExists,
-        getAccessibleEntries,
-        readFile,
-        realpath: path => path,
-        writeFile,
-        removeFile,
-    };
-    function getNodeFromPath(path) {
-        if (!path || path === "/") {
-            return root;
-        }
-        const segments = getPathComponents(path).slice(1);
-        let current = root;
-        for (const segment of segments) {
-            if (current.type !== "directory") {
-                return undefined;
-            }
-            const child = current.children[segment];
-            if (!child) {
-                return undefined;
-            }
-            current = child;
-        }
-        return current;
-    }
-    function ensureDirectory(segments) {
-        let current = root;
-        for (const segment of segments) {
-            if (!current.children[segment]) {
-                current.children[segment] = { type: "directory", children: {} };
-            }
-            else if (current.children[segment].type !== "directory") {
-                throw new Error(`Cannot create directory: a file already exists at "/${segments.join("/")}"`);
-            }
-            current = current.children[segment];
-        }
-        return current;
-    }
-    function addToTree(path) {
-        const segments = getPathComponents(path).slice(1);
-        if (segments.length === 0) {
-            throw new Error(`Invalid file path: "${path}"`);
+import getExePath from "#getExePath";
+import { dirname } from "node:path";
+import { normalizePath } from "./path.js";
+import { resolveFileName, } from "./proto.js";
+const useOS = Symbol("useOS");
+const identity = Symbol("identity");
+const fakeStat = Symbol("fakeStat");
+const noop = Symbol("noop");
+const error = Symbol("error");
+export const serverFS = {
+    useOS: useOS,
+    identity: identity,
+    fakeStat: fakeStat,
+    noop: noop,
+    error: error,
+};
+/** Creates a full request filesystem. The server derives directory listings when omitted. */
+export function createFileSystem(files, options = {}) {
+    return createRequestFileSystem("full", files, options);
+}
+/**
+ * Creates a full request filesystem with the compiler's default library
+ * directory mounted read-only through the host filesystem.
+ */
+export function createFileSystemWithLib(files, options = {}) {
+    const defaultLibraryPaths = options.defaultLibraryPath
+        ? [normalizePath(options.defaultLibraryPath)]
+        : [normalizePath("bundled:///libs")];
+    if (!options.defaultLibraryPath) {
+        try {
+            defaultLibraryPaths.push(normalizePath(dirname(getExePath())));
         }
-        const filename = segments.pop();
-        const dirNode = ensureDirectory(segments);
-        dirNode.children[filename] = { type: "file" };
-    }
-    function writeFile(path, data) {
-        content[path] = data;
-        addToTree(path);
-    }
-    function removeFile(path) {
-        delete content[path];
-        const segments = getPathComponents(path).slice(1);
-        if (segments.length === 0)
-            return;
-        const filename = segments.pop();
-        const dirNode = getNodeFromPath("/" + segments.join("/"));
-        if (dirNode && dirNode.type === "directory") {
-            delete dirNode.children[filename];
+        catch {
+            // A socket-connected embedded server can provide bundled libs without
+            // a locally installed compiler executable.
         }
     }
-    function directoryExists(directoryName) {
-        const node = getNodeFromPath(directoryName);
-        return !!node && node.type === "directory";
-    }
-    function fileExists(fileName) {
-        return fileName in content;
-    }
-    function getAccessibleEntries(directoryName) {
-        const node = getNodeFromPath(directoryName);
-        if (!node || node.type !== "directory") {
-            return undefined;
-        }
-        const fileEntries = [];
-        const directories = [];
-        for (const [name, child] of Object.entries(node.children)) {
-            if (child.type === "file") {
-                fileEntries.push(name);
-            }
-            else {
-                directories.push(name);
-            }
-        }
-        return { files: fileEntries, directories };
+    const symlinks = { ...options.symlinks };
+    for (const defaultLibraryPath of defaultLibraryPaths) {
+        symlinks[defaultLibraryPath] ??= { target: defaultLibraryPath, host: true };
     }
-    function readFile(fileName) {
-        if (fileName in content) {
-            return content[fileName];
+    return createRequestFileSystem("full", files, {
+        symlinks,
+        directories: options.directories,
+        removedPaths: options.removedPaths?.length ? options.removedPaths : undefined,
+    });
+}
+/** Creates a request filesystem layer, merging base directory listings when omitted. */
+export function createFileSystemLayer(files, options = {}) {
+    return createRequestFileSystem("layer", files, options);
+}
+function createRequestFileSystem(kind, files, options) {
+    const normalizedFiles = new Map();
+    for (const [id, content] of files) {
+        const fileName = normalizePath(resolveFileName(id));
+        if (normalizedFiles.has(fileName)) {
+            throw new Error(`Duplicate request filesystem path: ${fileName}`);
         }
-        return undefined;
+        normalizedFiles.set(fileName, content);
     }
+    const fileRecord = Object.fromEntries(normalizedFiles);
+    return {
+        kind,
+        files: fileRecord,
+        directories: options.directories,
+        symlinks: options.symlinks,
+        removedPaths: options.removedPaths?.length ? [...options.removedPaths] : undefined,
+    };
 }
 //# sourceMappingURL=fs.js.map

package/dist/api/fs.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/api/fs.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/api/fs.ts"],"names":[],"mappings":"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"}

package/dist/api/fsCallbacks.d.ts

@@ -0,0 +1,27 @@
+import { type FileSystemCallbacks, serverFS } from "./fs.ts";
+type ServerFSSentinelName = keyof typeof serverFS;
+type ServerFSSentinel = typeof serverFS[ServerFSSentinelName];
+type ServerFSSentinelResponse = {
+    [K in ServerFSSentinelName]: {
+        kind: K;
+    };
+}[ServerFSSentinelName];
+export type FileSystemCallbackResponse = {
+    kind: "value";
+    value?: unknown;
+} | {
+    kind: "missing";
+} | ServerFSSentinelResponse;
+interface FileSystemCallbackDefinition {
+    serverFS: readonly ServerFSSentinel[];
+}
+declare const fileSystemCallbackTable: Record<keyof FileSystemCallbacks, FileSystemCallbackDefinition>;
+type FileSystemCallbackName = keyof typeof fileSystemCallbackTable;
+export interface FileSystemCallbackConfiguration {
+    callbackNames: FileSystemCallbackName[];
+    arguments: string[];
+}
+export declare function configureFileSystemCallbacks(fs: FileSystemCallbacks | undefined): FileSystemCallbackConfiguration;
+export declare function encodeFileSystemCallbackResult(name: FileSystemCallbackName, result: unknown): FileSystemCallbackResponse;
+export {};
+//# sourceMappingURL=fsCallbacks.d.ts.map

package/dist/api/fsCallbacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fsCallbacks.d.ts","sourceRoot":"","sources":["../../src/api/fsCallbacks.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,mBAAmB,EACxB,QAAQ,EACX,MAAM,SAAS,CAAC;AAEjB,KAAK,oBAAoB,GAAG,MAAM,OAAO,QAAQ,CAAC;AAClD,KAAK,gBAAgB,GAAG,OAAO,QAAQ,CAAC,oBAAoB,CAAC,CAAC;AAC9D,KAAK,wBAAwB,GAAG;KAC3B,CAAC,IAAI,oBAAoB,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;KAAE;CAC5C,CAAC,oBAAoB,CAAC,CAAC;AAExB,MAAM,MAAM,0BAA0B,GAChC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAAE,GACnC;IAAE,IAAI,EAAE,SAAS,CAAC;CAAE,GACpB,wBAAwB,CAAC;AAE/B,UAAU,4BAA4B;IAClC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACzC;AAED,QAAA,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,mBAAmB,EAAE,4BAA4B,CAiB5F,CAAC;AAEF,KAAK,sBAAsB,GAAG,MAAM,OAAO,uBAAuB,CAAC;AAInE,MAAM,WAAW,+BAA+B;IAC5C,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACxC,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,wBAAgB,4BAA4B,CAAC,EAAE,EAAE,mBAAmB,GAAG,SAAS,GAAG,+BAA+B,CAyBjH;AAED,wBAAgB,8BAA8B,CAC1C,IAAI,EAAE,sBAAsB,EAC5B,MAAM,EAAE,OAAO,GAChB,0BAA0B,CAoD5B"}

package/dist/api/fsCallbacks.js

@@ -0,0 +1,111 @@
+import { serverFS, } from "./fs.js";
+const fileSystemCallbackTable = {
+    readFile: { serverFS: [serverFS.useOS, serverFS.error] },
+    fileExists: { serverFS: [serverFS.useOS, serverFS.error] },
+    directoryExists: { serverFS: [serverFS.useOS, serverFS.error] },
+    getAccessibleEntries: { serverFS: [serverFS.useOS, serverFS.error] },
+    realpath: {
+        serverFS: [serverFS.useOS, serverFS.identity, serverFS.error],
+    },
+    stat: {
+        serverFS: [serverFS.useOS, serverFS.fakeStat, serverFS.error],
+    },
+    writeFile: {
+        serverFS: [serverFS.useOS, serverFS.noop, serverFS.error],
+    },
+    removeFile: {
+        serverFS: [serverFS.useOS, serverFS.noop, serverFS.error],
+    },
+};
+const fsCallbackNames = Object.keys(fileSystemCallbackTable);
+const serverFSSentinelNames = Object.keys(serverFS);
+export function configureFileSystemCallbacks(fs) {
+    if (!fs) {
+        return { callbackNames: [], arguments: [] };
+    }
+    const callbackNames = [];
+    const args = [];
+    for (const name of fsCallbackNames) {
+        const value = fs[name];
+        if (typeof value === "function") {
+            callbackNames.push(name);
+            continue;
+        }
+        const sentinel = fileSystemCallbackTable[name].serverFS.find(sentinel => sentinel === value);
+        if (sentinel) {
+            const sentinelName = getServerFSSentinelName(sentinel);
+            if (sentinelName !== "useOS") {
+                args.push(`${name}:${sentinelName}`);
+            }
+            continue;
+        }
+        throw new TypeError(`Invalid filesystem callback '${name}': expected a function or a supported serverFS sentinel`);
+    }
+    args.push(...callbackNames);
+    return { callbackNames, arguments: args };
+}
+export function encodeFileSystemCallbackResult(name, result) {
+    const sentinel = fileSystemCallbackTable[name].serverFS.find(sentinel => sentinel === result);
+    if (sentinel) {
+        return { kind: getServerFSSentinelName(sentinel) };
+    }
+    let valid;
+    switch (name) {
+        case "directoryExists":
+        case "fileExists":
+            valid = typeof result === "boolean";
+            break;
+        case "getAccessibleEntries": {
+            const entries = result;
+            valid = !!entries
+                && isStringArray(entries.files)
+                && isStringArray(entries.directories)
+                && (entries.symlinks === undefined || isStringArray(entries.symlinks));
+            break;
+        }
+        case "readFile":
+            if (result === undefined)
+                return { kind: "missing" };
+            valid = typeof result === "string";
+            break;
+        case "realpath":
+            valid = typeof result === "string";
+            break;
+        case "stat": {
+            if (result === undefined)
+                return { kind: "missing" };
+            const stat = result;
+            valid = !!stat
+                && typeof stat.mode === "number"
+                && Number.isSafeInteger(stat.mode)
+                && stat.mode >= 0
+                && stat.mode <= 0xffff_ffff
+                && typeof stat.size === "number"
+                && Number.isSafeInteger(stat.size)
+                && stat.size >= 0
+                && stat.mtime instanceof Date
+                && !Number.isNaN(stat.mtime.getTime());
+            break;
+        }
+        case "writeFile":
+        case "removeFile":
+            valid = result === undefined;
+            break;
+    }
+    if (!valid) {
+        throw new TypeError(`Invalid result from filesystem callback '${name}'`);
+    }
+    return name === "writeFile" || name === "removeFile" ? { kind: "value" } : { kind: "value", value: result };
+}
+function isStringArray(value) {
+    return Array.isArray(value) && value.every(element => typeof element === "string");
+}
+function getServerFSSentinelName(sentinel) {
+    for (const name of serverFSSentinelNames) {
+        if (serverFS[name] === sentinel) {
+            return name;
+        }
+    }
+    throw new TypeError("Unknown serverFS sentinel");
+}
+//# sourceMappingURL=fsCallbacks.js.map