@spyglassmc/core 0.1.1 → 0.3.0

package/lib/service/Project.js

@@ -1,180 +1,99 @@
-"use strict";
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
-    if (kind === "m") throw new TypeError("Private method is not writable");
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
-    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
-};
-var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
-    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
-    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
-    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-var _Project_cacheSaverIntervalId, _Project_clientManagedUris, _Project_configService, _Project_docAndNodes, _Project_initializers, _Project_initPromise, _Project_readyPromise, _Project_watchedFiles, _Project_watcher, _Project_watcherReady, _Project_isReady, _Project_dependencyRoots, _Project_dependencyFiles, _Project_roots, _Project_ctx, _Project_cacheRoot;
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Project = exports.ProjectData = void 0;
-const chokidar_1 = __importDefault(require("chokidar"));
-const events_1 = __importDefault(require("events"));
-const p_limit_1 = __importDefault(require("p-limit"));
-const vscode_languageserver_textdocument_1 = require("vscode-languageserver-textdocument");
-const _1 = require(".");
-const common_1 = require("../common");
-const node_1 = require("../node");
-const parser_1 = require("../parser");
-const processor_1 = require("../processor");
-const source_1 = require("../source");
-const symbol_1 = require("../symbol");
-const CacheService_1 = require("./CacheService");
-const Config_1 = require("./Config");
-const Context_1 = require("./Context");
-const Dependency_1 = require("./Dependency");
-const Downloader_1 = require("./Downloader");
-const ErrorReporter_1 = require("./ErrorReporter");
-const FileService_1 = require("./FileService");
-const fileUtil_1 = require("./fileUtil");
-const Logger_1 = require("./Logger");
-const MetaRegistry_1 = require("./MetaRegistry");
-const Profiler_1 = require("./Profiler");
+import { TextDocument } from 'vscode-languageserver-textdocument';
+import { bufferToString, Logger, SingletonPromise, StateProxy } from '../common/index.js';
+import { FileNode } from '../node/index.js';
+import { file } from '../parser/index.js';
+import { traversePreOrder } from '../processor/index.js';
+import { Source } from '../source/index.js';
+import { SymbolUtil } from '../symbol/index.js';
+import { CacheService } from './CacheService.js';
+import { ConfigService, LinterConfigValue } from './Config.js';
+import { BinderContext, CheckerContext, LinterContext, ParserContext, UriBinderContext } from './Context.js';
+import { DependencyKey } from './Dependency.js';
+import { Downloader } from './Downloader.js';
+import { LinterErrorReporter } from './ErrorReporter.js';
+import { ArchiveUriSupporter, FileService, FileUriSupporter } from './FileService.js';
+import { fileUtil } from './fileUtil.js';
+import { MetaRegistry } from './MetaRegistry.js';
+import { ProfilerFactory } from './Profiler.js';
 const CacheAutoSaveInterval = 600000; // 10 Minutes.
-var ProjectData;
-(function (ProjectData) {
-    function mock(data = {}) {
-        const cacheRoot = data.cacheRoot ?? '/some/random/garbage/path/that/definitely/does/not/exist';
-        const logger = data.logger ?? Logger_1.Logger.create();
-        const downloader = data.downloader ?? new Downloader_1.Downloader(cacheRoot, logger, _1.LowLevelDownloader.mock({ fixtures: {} }));
-        return {
-            cacheRoot,
-            config: data.config ?? Config_1.VanillaConfig,
-            ctx: data.ctx ?? {},
-            downloader,
-            ensureParsedAndChecked: data.ensureParsedAndChecked,
-            fs: data.fs ?? FileService_1.FileService.create(),
-            get: data.get ?? (() => undefined),
-            logger,
-            meta: data.meta ?? new MetaRegistry_1.MetaRegistry(),
-            profilers: data.profilers ?? Profiler_1.ProfilerFactory.noop(),
-            projectRoot: data.projectRoot ?? 'file:///',
-            roots: data.roots ?? [],
-            symbols: data.symbols ?? new symbol_1.SymbolUtil({}),
-        };
-    }
-    ProjectData.mock = mock;
-})(ProjectData = exports.ProjectData || (exports.ProjectData = {}));
 /* istanbul ignore next */
 /**
  * Manage all tracked documents and errors.
+ *
+ * The four stages of processing a document:
+ * 1. `read` - read the file from the external file system as a `TextDocument`.
+ * 2. `parse` - Parse the `TextDocument` into an `AstNode`.
+ * 3. `bind` - Bind the `AstNode` and populate both the global symbol table and the local symbol tables on the nodes.
+ * 4. `check` (includes `lint`) - Check the `AstNode` with information from the symbol tables.
+ *
+ * **Caching**
+ *
+ * The global symbol table along with a list of file URIs and checksums is cached in memory and is periodically saved to disk.
+ *
+ * The `TextDocument`s and file `AstNode`s (including their local symbol tables) managed by the client are stored in memory until the client sends a `didClose` notification.
+ *
+ * Some `TextDocument`s may be cached to avoid excessive reading from the file system.
+ *
+ * **INIT and READY**
+ *
+ * When a new instance of the {@link Project} class is constructed, its INIT and READY processes are immediately started in serial.
+ *
+ * During the INIT process of the project, the config and language feature initialization are processed.
+ * The Promise returned by the {@link init} function resolves when the INIT process is complete.
+ *
+ * During the READY process of the project, the whole project is analyzed mainly to populate the global symbol table.
+ * The Promise returned by the {@link ready} function resolves when the READY process is complete.
+ *
+ * The following generally happens during the READY process:
+ * 1. A list of file URIs under the project is obtained.
+ * 2. The global symbol cache, if available, is loaded and validated against the know list of files.
+ *    A list of files that need to be (re)processed is returned in this step.
+ * 3. For each files in the new list, the file is read, parsed, bound, and checked.
+ *
+ * **EDITING**
+ *
+ * After the READY process is complete, editing text documents as signaled by the client or the file watcher results in the file being re-processed.
  */
-class Project extends events_1.default {
-    constructor({ cacheRoot, downloader, fs = FileService_1.FileService.create(), initializers = [], logger = Logger_1.Logger.create(), profilers = Profiler_1.ProfilerFactory.noop(), projectPath, }) {
-        super();
-        _Project_cacheSaverIntervalId.set(this, void 0);
-        /**
-         * URI of files that are currently managed by the language client.
-         */
-        _Project_clientManagedUris.set(this, new Set());
-        _Project_configService.set(this, void 0);
-        _Project_docAndNodes.set(this, new Map());
-        _Project_initializers.set(this, void 0);
-        _Project_initPromise.set(this, void 0);
-        _Project_readyPromise.set(this, void 0);
-        _Project_watchedFiles.set(this, new Set());
-        _Project_watcher.set(this, void 0);
-        _Project_watcherReady.set(this, false);
-        _Project_isReady.set(this, false);
-        this.meta = new MetaRegistry_1.MetaRegistry();
-        _Project_dependencyRoots.set(this, void 0);
-        _Project_dependencyFiles.set(this, void 0);
-        _Project_roots.set(this, []
-        /**
-         * All tracked root URIs. Each URI in this array is guaranteed to end with a slash (`/`).
-         *
-         * Includes the roots of all dependencies, the project root, and all data pack roots identified
-         * by `pack.mcmeta` files.
-         *
-         * Some URIs in the array may overlap with each other. In such cases, the deeper ones are guaranteed to come
-         * before the shallower ones (e.g. `file:///foo/bar/` will come before `file:///foo/`).
-         */
-        );
-        _Project_ctx.set(this, void 0);
-        _Project_cacheRoot.set(this, void 0);
-        __classPrivateFieldSet(this, _Project_cacheRoot, cacheRoot, "f");
-        this.cacheService = new CacheService_1.CacheService(cacheRoot, this);
-        __classPrivateFieldSet(this, _Project_configService, new Config_1.ConfigService(this), "f");
-        this.downloader = downloader ?? new Downloader_1.Downloader(cacheRoot, logger);
-        this.fs = fs;
-        __classPrivateFieldSet(this, _Project_initializers, initializers, "f");
-        this.logger = logger;
-        this.profilers = profilers;
-        this.projectPath = projectPath;
-        this.projectRoot = fileUtil_1.fileUtil.ensureEndingSlash(fileUtil_1.fileUtil.pathToFileUri(projectPath));
-        this.symbols = new symbol_1.SymbolUtil({});
-        __classPrivateFieldSet(this, _Project_ctx, {}, "f");
-        this.logger.info(`[Project] [init] cacheRoot = “${cacheRoot}”`);
-        __classPrivateFieldGet(this, _Project_configService, "f")
-            .on('changed', ({ config }) => {
-            this.config = config;
-            this.logger.info('[Project] [Config] Changed');
-        })
-            .on('error', ({ error, uri }) => this.logger.error(`[Project] [Config] Failed loading “${uri}”`, error));
-        this.setInitPromise();
-        this.setReadyPromise();
-        __classPrivateFieldSet(this, _Project_cacheSaverIntervalId, setInterval(() => this.cacheService.save(), CacheAutoSaveInterval), "f");
-        this
-            .on('documentUpdated', ({ doc, node }) => {
-            if (!__classPrivateFieldGet(this, _Project_isReady, "f")) {
-                return;
-            }
-            this.emit('documentErrorred', {
-                doc,
-                errors: node_1.FileNode.getErrors(node),
-                node,
-            });
-        })
-            .on('fileCreated', async ({ uri }) => {
-            if (uri.endsWith(Project.RootSuffix)) {
-                this.updateRoots();
-            }
-            this.bind(uri);
-            return this.ensureParsedAndChecked(uri);
-        })
-            .on('fileModified', async ({ uri }) => {
-            if (this.isOnlyWatched(uri)) {
-                __classPrivateFieldGet(this, _Project_docAndNodes, "f").delete(uri);
-                await this.ensureParsedAndChecked(uri);
-            }
-        })
-            .on('fileDeleted', ({ uri }) => {
-            if (uri.endsWith(Project.RootSuffix)) {
-                this.updateRoots();
-            }
-            this.symbols.clear({ uri });
-            this.tryClearingCache(uri);
-        })
-            .on('ready', () => {
-            __classPrivateFieldSet(this, _Project_isReady, true, "f");
-            // Recheck client managed files.
-            const promises = [];
-            for (const uri of __classPrivateFieldGet(this, _Project_clientManagedUris, "f")) {
-                const result = __classPrivateFieldGet(this, _Project_docAndNodes, "f").get(uri);
-                if (result) {
-                    promises.push(this.check(result.doc, result.node));
-                }
-            }
-            Promise.all(promises).catch(e => this.logger.error('[Project#ready] Error occurred when rechecking client managed files after ready', e));
-        });
-    }
+export class Project {
+    static RootSuffix = '/pack.mcmeta';
+    /** Prevent circular binding. */
+    #bindingInProgressUris = new Set();
+    #cacheSaverIntervalId;
+    cacheService;
+    /** URI of files that are currently managed by the language client. */
+    #clientManagedUris = new Set();
+    #clientManagedDocAndNodes = new Map();
+    #configService;
+    #symbolUpToDateUris = new Set();
+    #eventEmitter;
+    #initializers;
+    #initPromise;
+    #readyPromise;
+    #watchedFiles = new Set();
+    #watcher;
+    #watcherReady = false;
+    #isReady = false;
     get isReady() {
-        return __classPrivateFieldGet(this, _Project_isReady, "f");
-    }
+        return this.#isReady;
+    }
+    config;
+    downloader;
+    externals;
+    fs;
+    logger;
+    meta = new MetaRegistry();
+    profilers;
+    projectRoot;
+    symbols;
+    #dependencyRoots;
+    #dependencyFiles;
+    #roots = [];
     /**
      * All tracked root URIs. Each URI in this array is guaranteed to end with a slash (`/`).
      *
@@ -185,22 +104,24 @@ class Project extends events_1.default {
      * before the shallower ones (e.g. `file:///foo/bar/` will come before `file:///foo/`).
      */
     get roots() {
-        return __classPrivateFieldGet(this, _Project_roots, "f");
+        return this.#roots;
     }
+    #ctx;
     /**
      * Arbitrary information that will be included in the `project` property of all `Context`s.
      */
     get ctx() {
-        return __classPrivateFieldGet(this, _Project_ctx, "f");
+        return this.#ctx;
     }
+    #cacheRoot;
     /**
-     * File path to a directory where all cache files of Spyglass should be stored.
+     * File URI to a directory where all cache files of Spyglass should be stored.
      */
     get cacheRoot() {
-        return __classPrivateFieldGet(this, _Project_cacheRoot, "f");
+        return this.#cacheRoot;
     }
     updateRoots() {
-        const rawRoots = [...__classPrivateFieldGet(this, _Project_dependencyRoots, "f"), this.projectRoot];
+        const rawRoots = [...this.#dependencyRoots, this.projectRoot];
         const ans = new Set(rawRoots);
         // Identify roots indicated by `pack.mcmeta`.
         for (const file of this.getTrackedFiles()) {
@@ -208,8 +129,19 @@ class Project extends events_1.default {
                 ans.add(file.slice(0, 1 - Project.RootSuffix.length));
             }
         }
-        __classPrivateFieldSet(this, _Project_roots, [...ans].sort((a, b) => b.length - a.length), "f");
-        this.emit('rootsUpdated', { roots: __classPrivateFieldGet(this, _Project_roots, "f") });
+        this.#roots = [...ans].sort((a, b) => b.length - a.length);
+        this.emit('rootsUpdated', { roots: this.#roots });
+    }
+    on(event, callbackFn) {
+        this.#eventEmitter.on(event, callbackFn);
+        return this;
+    }
+    once(event, callbackFn) {
+        this.#eventEmitter.once(event, callbackFn);
+        return this;
+    }
+    emit(event, ...args) {
+        return this.#eventEmitter.emit(event, ...args);
     }
     /**
      * Get all files that are tracked and supported.
@@ -219,38 +151,105 @@ class Project extends events_1.default {
      */
     getTrackedFiles() {
         const extensions = this.meta.getSupportedFileExtensions();
-        return [...__classPrivateFieldGet(this, _Project_dependencyFiles, "f"), ...__classPrivateFieldGet(this, _Project_watchedFiles, "f")]
-            .filter(file => extensions.includes(fileUtil_1.fileUtil.extname(file) ?? ''));
+        return [...this.#dependencyFiles, ...this.#watchedFiles]
+            .filter(file => extensions.includes(fileUtil.extname(file) ?? ''));
+    }
+    constructor({ cacheRoot, defaultConfig, downloader, externals, fs = FileService.create(externals, cacheRoot), initializers = [], logger = Logger.create(), profilers = ProfilerFactory.noop(), projectRoot, }) {
+        this.#cacheRoot = cacheRoot;
+        this.#eventEmitter = new externals.event.EventEmitter();
+        this.externals = externals;
+        this.fs = fs;
+        this.#initializers = initializers;
+        this.logger = logger;
+        this.profilers = profilers;
+        this.projectRoot = projectRoot;
+        this.cacheService = new CacheService(cacheRoot, this);
+        this.#configService = new ConfigService(this, defaultConfig);
+        this.downloader = downloader ?? new Downloader(cacheRoot, externals, logger);
+        this.symbols = new SymbolUtil({}, externals.event.EventEmitter);
+        this.#ctx = {};
+        this.logger.info(`[Project] [init] cacheRoot = “${cacheRoot}”`);
+        this.#configService
+            .on('changed', ({ config }) => {
+            this.config = config;
+            this.logger.info('[Project] [Config] Changed');
+        })
+            .on('error', ({ error, uri }) => this.logger.error(`[Project] [Config] Failed loading “${uri}”`, error));
+        this.setInitPromise();
+        this.setReadyPromise();
+        this.#cacheSaverIntervalId = setInterval(() => this.cacheService.save(), CacheAutoSaveInterval);
+        this
+            .on('documentUpdated', ({ doc, node }) => {
+            // if (!this.#isReady) {
+            // 	return
+            // }
+            this.emit('documentErrorred', {
+                doc,
+                errors: FileNode.getErrors(node),
+                node,
+            });
+        })
+            .on('fileCreated', async ({ uri }) => {
+            if (uri.endsWith(Project.RootSuffix)) {
+                this.updateRoots();
+            }
+            this.bindUri(uri);
+            return this.ensureBindingStarted(uri);
+        })
+            .on('fileModified', async ({ uri }) => {
+            this.#symbolUpToDateUris.delete(uri);
+            if (this.isOnlyWatched(uri)) {
+                await this.ensureBindingStarted(uri);
+            }
+        })
+            .on('fileDeleted', ({ uri }) => {
+            if (uri.endsWith(Project.RootSuffix)) {
+                this.updateRoots();
+            }
+            this.#symbolUpToDateUris.delete(uri);
+            this.symbols.clear({ uri });
+            this.tryClearingCache(uri);
+        })
+            .on('ready', () => {
+            this.#isReady = true;
+            // // Recheck client managed files after the READY process, as they may have incomplete results and are user-facing.
+            // const promises: Promise<unknown>[] = []
+            // for (const { doc, node } of this.#clientManagedDocAndNodes.values()) {
+            // 	promises.push(this.check(doc, node))
+            // }
+            // Promise.all(promises).catch(e => this.logger.error('[Project#ready] Error occurred when rechecking client managed files after READY', e))
+        });
     }
     setInitPromise() {
         const loadConfig = async () => {
-            this.config = await __classPrivateFieldGet(this, _Project_configService, "f").load();
+            this.config = await this.#configService.load();
         };
         const callIntializers = async () => {
             const initCtx = {
                 cacheRoot: this.cacheRoot,
                 config: this.config,
                 downloader: this.downloader,
+                externals: this.externals,
                 logger: this.logger,
                 meta: this.meta,
                 projectRoot: this.projectRoot,
             };
-            const results = await Promise.allSettled(__classPrivateFieldGet(this, _Project_initializers, "f").map(init => init(initCtx)));
+            const results = await Promise.allSettled(this.#initializers.map(init => init(initCtx)));
             let ctx = {};
             results.forEach(async (r, i) => {
                 if (r.status === 'rejected') {
-                    this.logger.error(`[Project] [callInitializers] [${i}] “${__classPrivateFieldGet(this, _Project_initializers, "f")[i].name}”`, r.reason);
+                    this.logger.error(`[Project] [callInitializers] [${i}] “${this.#initializers[i].name}”`, r.reason);
                 }
                 else if (r.value) {
                     ctx = { ...ctx, ...r.value };
                 }
             });
-            __classPrivateFieldSet(this, _Project_ctx, ctx, "f");
+            this.#ctx = ctx;
         };
         const init = async () => {
             const __profiler = this.profilers.get('project#init');
             const { symbols } = await this.cacheService.load();
-            this.symbols = new symbol_1.SymbolUtil(symbols);
+            this.symbols = new SymbolUtil(symbols, this.externals.event.EventEmitter);
             this.symbols.buildCache();
             __profiler.task('Load Cache');
             await loadConfig();
@@ -258,13 +257,13 @@ class Project extends events_1.default {
             await callIntializers();
             __profiler.task('Initialize').finalize();
         };
-        __classPrivateFieldSet(this, _Project_initPromise, init(), "f");
+        this.#initPromise = init();
     }
     setReadyPromise() {
         const getDependencies = async () => {
             const ans = [];
             for (const dependency of this.config.env.dependencies) {
-                if (Dependency_1.DependencyKey.is(dependency)) {
+                if (DependencyKey.is(dependency)) {
                     const provider = this.meta.getDependencyProvider(dependency);
                     if (provider) {
                         try {
@@ -287,57 +286,51 @@ class Project extends events_1.default {
         };
         const listDependencyFiles = async () => {
             const dependencies = await getDependencies();
-            const fileUriSupporter = await FileService_1.FileUriSupporter.create(dependencies, this.logger);
-            const spyglassUriSupporter = await FileService_1.SpyglassUriSupporter.create(dependencies, this.logger, this.cacheService.checksums.roots);
+            const fileUriSupporter = await FileUriSupporter.create(dependencies, this.externals, this.logger);
+            const archiveUriSupporter = await ArchiveUriSupporter.create(dependencies, this.externals, this.logger, this.cacheService.checksums.roots);
             this.fs.register('file:', fileUriSupporter, true);
-            this.fs.register(common_1.SpyglassUri.Protocol, spyglassUriSupporter, true);
+            this.fs.register(ArchiveUriSupporter.Protocol, archiveUriSupporter, true);
         };
         const listProjectFiles = () => new Promise(resolve => {
-            __classPrivateFieldSet(this, _Project_watcherReady, false, "f");
-            __classPrivateFieldSet(this, _Project_watcher, chokidar_1.default
-                .watch(this.projectPath, { ignoreInitial: false })
+            this.#watcherReady = false;
+            this.#watcher = this.externals.fs
+                .watch(this.projectRoot)
                 .once('ready', () => {
-                __classPrivateFieldSet(this, _Project_watcherReady, true, "f");
+                this.#watcherReady = true;
                 resolve();
             })
-                .on('add', path => {
-                const uri = fileUtil_1.fileUtil.pathToFileUri(path);
-                __classPrivateFieldGet(this, _Project_watchedFiles, "f").add(uri);
-                if (__classPrivateFieldGet(this, _Project_watcherReady, "f")) {
+                .on('add', uri => {
+                this.#watchedFiles.add(uri);
+                if (this.#watcherReady) {
                     this.emit('fileCreated', { uri });
                 }
             })
-                .on('change', path => {
-                const uri = fileUtil_1.fileUtil.pathToFileUri(path);
-                if (__classPrivateFieldGet(this, _Project_watcherReady, "f")) {
+                .on('change', uri => {
+                if (this.#watcherReady) {
                     this.emit('fileModified', { uri });
                 }
             })
-                .on('unlink', path => {
-                const uri = fileUtil_1.fileUtil.pathToFileUri(path);
-                __classPrivateFieldGet(this, _Project_watchedFiles, "f").delete(uri);
-                if (__classPrivateFieldGet(this, _Project_watcherReady, "f")) {
+                .on('unlink', uri => {
+                this.#watchedFiles.delete(uri);
+                if (this.#watcherReady) {
                     this.emit('fileDeleted', { uri });
                 }
             })
                 .on('error', e => {
                 this.logger.error('[Project] [chokidar]', e);
-            }), "f");
+            });
         });
         const ready = async () => {
             await this.init();
             const __profiler = this.profilers.get('project#ready');
-            const limit = (0, p_limit_1.default)(8);
-            const ensureParsed = this.ensureParsed.bind(this);
-            const ensureChecked = this.ensureChecked.bind(this);
             await Promise.all([
                 listDependencyFiles(),
                 listProjectFiles(),
             ]);
-            __classPrivateFieldSet(this, _Project_dependencyFiles, new Set(this.fs.listFiles()), "f");
-            __classPrivateFieldSet(this, _Project_dependencyRoots, new Set(this.fs.listRoots()), "f");
+            this.#dependencyFiles = new Set(this.fs.listFiles());
+            this.#dependencyRoots = new Set(this.fs.listRoots());
             this.updateRoots();
-            __profiler.task('List Files');
+            __profiler.task('List URIs');
             for (const [id, { checksum, registrar }] of this.meta.symbolRegistrars) {
                 const cacheChecksum = this.cacheService.checksums.symbolRegistrars[id];
                 if (cacheChecksum === undefined || checksum !== cacheChecksum) {
@@ -358,39 +351,48 @@ class Project extends events_1.default {
             }
             __profiler.task('Validate Cache');
             if (addedFiles.length > 0) {
-                this.bind(addedFiles);
+                this.bindUri(addedFiles);
             }
             __profiler.task('Bind URIs');
-            const files = [...addedFiles, ...changedFiles]; // FIXME: nbtdoc files might need to be parsed and checked before others.
-            // const docAndNodes = (await Promise.all(files.map(uri => limit(ensureParsed, uri)))).filter((r): r is DocAndNode => !!r)
-            const docAndNodes = (await Promise.all(files.map(uri => ensureParsed(uri)))).filter((r) => !!r);
-            __profiler.task('Parse Files');
-            // await Promise.all(docAndNodes.map(({ doc, node }) => limit(ensureChecked, doc, node)))
-            await Promise.all(docAndNodes.map(({ doc, node }) => ensureChecked(doc, node)));
-            __profiler.task('Check Files').finalize();
+            const files = [...addedFiles, ...changedFiles].sort(this.meta.uriSorter);
+            __profiler.task('Sort URIs');
+            const __bindProfiler = this.profilers.get('project#ready#bind', 'top-n', 50);
+            for (const uri of files) {
+                await this.ensureBindingStarted(uri);
+                __bindProfiler.task(uri);
+            }
+            __bindProfiler.finalize();
+            __profiler.task('Bind Files');
+            __profiler.finalize();
             this.emit('ready', {});
         };
-        __classPrivateFieldSet(this, _Project_readyPromise, ready(), "f");
+        this.#readyPromise = ready();
     }
+    /**
+     * Load the config file and initialize parsers and processors.
+     */
     async init() {
-        await __classPrivateFieldGet(this, _Project_initPromise, "f");
+        await this.#initPromise;
         return this;
     }
+    /**
+     * Finish the initial run of parsing, binding, and checking the entire project.
+     */
     async ready() {
-        await __classPrivateFieldGet(this, _Project_readyPromise, "f");
+        await this.#readyPromise;
         return this;
     }
     /**
      * Behavior of the `Project` instance is undefined after this function has settled.
      */
     async close() {
-        clearInterval(__classPrivateFieldGet(this, _Project_cacheSaverIntervalId, "f"));
-        await __classPrivateFieldGet(this, _Project_watcher, "f").close();
+        clearInterval(this.#cacheSaverIntervalId);
+        await this.#watcher.close();
         await this.cacheService.save();
     }
     async restart() {
         try {
-            await __classPrivateFieldGet(this, _Project_watcher, "f").close();
+            await this.#watcher.close();
             this.setReadyPromise();
             await this.ready();
         }
@@ -401,137 +403,186 @@ class Project extends events_1.default {
     resetCache() {
         return this.cacheService.reset();
     }
-    /**
-     * @returns The language ID of the file, or the file extension without the leading dot.
-     */
-    getLanguageID(uri) {
-        uri = fileUtil_1.fileUtil.normalize(uri);
-        const ext = fileUtil_1.fileUtil.extname(uri) ?? '.plaintext';
-        return this.meta.getLanguageID(ext) ?? ext.slice(1);
+    normalizeUri(uri) {
+        return this.fs.mapFromDisk(this.externals.uri.normalize(uri));
     }
-    /**
-     * @returns The cached `TextDocument` and `AstNode` for the URI, or `undefined` when such data isn't available in cache.
-     */
-    get(uri) {
-        uri = fileUtil_1.fileUtil.normalize(uri);
-        return __classPrivateFieldGet(this, _Project_docAndNodes, "f").get(uri);
+    static TextDocumentCacheMaxLength = 268435456;
+    #textDocumentCache = new Map();
+    #textDocumentCacheLength = 0;
+    removeCachedTextDocument(uri) {
+        const doc = this.#textDocumentCache.get(uri);
+        if (doc && !(doc instanceof Promise)) {
+            this.#textDocumentCacheLength -= doc.getText().length;
+        }
+        this.#textDocumentCache.delete(uri);
     }
-    /**
-     * @throws FS-related errors
-     */
-    async ensureParsed(uri) {
-        uri = fileUtil_1.fileUtil.normalize(uri);
-        if (__classPrivateFieldGet(this, _Project_docAndNodes, "f").has(uri)) {
-            return __classPrivateFieldGet(this, _Project_docAndNodes, "f").get(uri);
+    async read(uri) {
+        const getLanguageID = (uri) => {
+            const ext = fileUtil.extname(uri) ?? '.plaintext';
+            return this.meta.getLanguageID(ext) ?? ext.slice(1);
+        };
+        const createTextDocument = async (uri) => {
+            const languageId = getLanguageID(uri);
+            if (!this.meta.isSupportedLanguage(languageId)) {
+                return undefined;
+            }
+            try {
+                const content = bufferToString(await this.fs.readFile(uri));
+                return TextDocument.create(uri, languageId, -1, content);
+            }
+            catch (e) {
+                this.logger.warn(`[Project] [read] Failed creating TextDocument for “${uri}”`, e);
+                return undefined;
+            }
+        };
+        const trimCache = () => {
+            const iterator = this.#textDocumentCache.keys();
+            while (this.#textDocumentCacheLength > Project.TextDocumentCacheMaxLength) {
+                const result = iterator.next();
+                if (result.done) {
+                    throw new Error(`[Project] [read] Cache is too large with length ${this.#textDocumentCacheLength} even though it's empty; make sure to call 'removeCachedTextDocument()' instead of 'this.#textDocumentCache.delete()'`);
+                }
+                this.removeCachedTextDocument(result.value);
+            }
+        };
+        const getCacheHandlingPromise = async (uri) => {
+            if (this.#textDocumentCache.has(uri)) {
+                const ans = this.#textDocumentCache.get(uri);
+                // Move the entry to the end of the cache.
+                // The goal is that more-frequently-used entries are preferably not trimmed.
+                this.#textDocumentCache.delete(uri);
+                this.#textDocumentCache.set(uri, ans);
+                return ans;
+            }
+            else {
+                const promise = createTextDocument(uri);
+                this.#textDocumentCache.set(uri, promise);
+                // We replace the Promise in the cache with the TextDocument after it resolves,
+                // or removes it from the cache if it resolves to undefined.
+                const doc = await promise;
+                if (this.#textDocumentCache.get(uri) === promise) {
+                    // The Promise in the cache is the same as the one we created earlier.
+                    // This check is to make sure we don't set a wrong TextDocument to the cache in case the cache was modified elsewhere.
+                    if (doc) {
+                        this.#textDocumentCache.set(uri, doc);
+                        this.#textDocumentCacheLength += doc.getText().length;
+                        trimCache();
+                    }
+                    else {
+                        this.#textDocumentCache.delete(uri);
+                    }
+                }
+                return doc;
+            }
+        };
+        uri = this.normalizeUri(uri);
+        if (this.#clientManagedUris.has(uri)) {
+            const result = this.#clientManagedDocAndNodes.get(uri);
+            if (result) {
+                return result.doc;
+            }
+            throw new Error(`[Project] [read] Client-managed URI “${uri}” does not have a TextDocument in the cache`);
         }
-        const languageID = this.getLanguageID(uri);
-        if (!this.meta.isSupportedLanguage(languageID)) {
-            return undefined;
+        return getCacheHandlingPromise(uri);
+    }
+    parse(doc) {
+        const ctx = ParserContext.create(this, { doc });
+        const src = new Source(doc.getText());
+        const node = file()(src, ctx);
+        return node;
+    }
+    async bind(doc, node) {
+        if (node.binderErrors) {
+            return;
         }
         try {
-            const content = (0, common_1.bufferToString)(await this.fs.readFile(uri));
-            const doc = vscode_languageserver_textdocument_1.TextDocument.create(uri, languageID, -1, content);
-            return this.parseAndCache(doc);
+            this.#bindingInProgressUris.add(doc.uri);
+            const binder = this.meta.getBinder(node.type);
+            const ctx = BinderContext.create(this, { doc });
+            ctx.symbols.clear({ contributor: 'binder', uri: doc.uri });
+            await ctx.symbols.contributeAsAsync('binder', async () => {
+                const proxy = StateProxy.create(node);
+                await binder(proxy, ctx);
+                node.binderErrors = ctx.err.dump();
+            });
+            this.#bindingInProgressUris.delete(doc.uri);
+            this.#symbolUpToDateUris.add(doc.uri);
         }
         catch (e) {
-            this.logger.warn(`[Project] [ensureParsed] Failed for “${uri}”`, e);
-            return undefined;
+            this.logger.error(`[Project] [bind] Failed for “${doc.uri}” #${doc.version}`, e);
         }
     }
-    parseAndCache(doc) {
-        const node = this.parse(doc);
-        return this.cache(doc, node);
-    }
-    parse(doc) {
-        const ctx = Context_1.ParserContext.create(this, { doc });
-        const src = new source_1.Source(doc.getText());
-        let ans;
-        ctx.symbols.clear({ contributor: 'parser', uri: doc.uri });
-        ctx.symbols.contributeAs('parser', () => ans = (0, parser_1.file)()(src, ctx));
-        return ans;
-    }
-    cache(doc, node) {
-        const data = { doc, node };
-        __classPrivateFieldGet(this, _Project_docAndNodes, "f").set(doc.uri, data);
-        this.emit('documentUpdated', data);
-        return data;
-    }
     async check(doc, node) {
-        const checker = this.meta.getChecker(node.type);
-        const ctx = Context_1.CheckerContext.create(this, { doc });
-        ctx.symbols.clear({ contributor: 'checker', uri: doc.uri });
-        await ctx.symbols.contributeAsAsync('checker', async () => {
-            await checker(node, ctx);
-            node.checkerErrors = ctx.err.dump();
-            this.cache(doc, node);
-            this.ensureLinted(doc, node);
-        });
-    }
-    async ensureChecked(doc, node) {
-        if (!node.checkerErrors) {
-            try {
-                return this.check(doc, node);
-            }
-            catch (e) {
-                this.logger.error(`[Project] [ensuredChecked] Failed for “${doc.uri}” #${doc.version}`, e);
-            }
+        if (node.checkerErrors) {
+            return;
+        }
+        try {
+            const checker = this.meta.getChecker(node.type);
+            const ctx = CheckerContext.create(this, { doc });
+            ctx.symbols.clear({ contributor: 'checker', uri: doc.uri });
+            await ctx.symbols.contributeAsAsync('checker', async () => {
+                await checker(StateProxy.create(node), ctx);
+                node.checkerErrors = ctx.err.dump();
+                this.lint(doc, node);
+            });
+        }
+        catch (e) {
+            this.logger.error(`[Project] [check] Failed for “${doc.uri}” #${doc.version}`, e);
         }
     }
     lint(doc, node) {
+        if (node.linterErrors) {
+            return;
+        }
         node.linterErrors = [];
-        for (const [ruleName, rawValue] of Object.entries(this.config.lint)) {
-            const result = Config_1.LinterConfigValue.destruct(rawValue);
-            if (!result) {
-                // Rule is disabled (i.e. set to `null`) in the config.
-                continue;
-            }
-            const { ruleSeverity, ruleValue } = result;
-            const { configValidator, linter, nodePredicate } = this.meta.getLinter(ruleName);
-            if (!configValidator(ruleName, ruleValue, this.logger)) {
-                // Config value is invalid.
-                continue;
-            }
-            const ctx = Context_1.LinterContext.create(this, {
-                doc,
-                err: new ErrorReporter_1.LinterErrorReporter(ruleName, ruleSeverity),
-                ruleName,
-                ruleValue,
-            });
-            (0, processor_1.traversePreOrder)(node, () => true, () => true, node => {
-                if (nodePredicate(node)) {
-                    linter(node, ctx);
+        try {
+            for (const [ruleName, rawValue] of Object.entries(this.config.lint)) {
+                const result = LinterConfigValue.destruct(rawValue);
+                if (!result) {
+                    // Rule is disabled (i.e. set to `null`) in the config.
+                    continue;
                 }
-            });
-            node.linterErrors.push(...ctx.err.dump());
-        }
-        this.cache(doc, node);
-    }
-    ensureLinted(doc, node) {
-        if (!node.linterErrors) {
-            try {
-                this.lint(doc, node);
-            }
-            catch (e) {
-                this.logger.error(`[Project] [ensureLinted] Failed for “${doc.uri}” #${doc.version}`, e);
+                const { ruleSeverity, ruleValue } = result;
+                const { configValidator, linter, nodePredicate } = this.meta.getLinter(ruleName);
+                if (!configValidator(ruleName, ruleValue, this.logger)) {
+                    // Config value is invalid.
+                    continue;
+                }
+                const ctx = LinterContext.create(this, {
+                    doc,
+                    err: new LinterErrorReporter(ruleName, ruleSeverity),
+                    ruleName,
+                    ruleValue,
+                });
+                traversePreOrder(node, () => true, () => true, node => {
+                    if (nodePredicate(node)) {
+                        const proxy = StateProxy.create(node);
+                        linter(proxy, ctx);
+                    }
+                });
+                node.linterErrors.push(...ctx.err.dump());
             }
         }
-    }
-    async ensureParsedAndChecked(uri) {
-        const result = await this.ensureParsed(uri);
-        if (result) {
-            await this.ensureChecked(result.doc, result.node);
+        catch (e) {
+            this.logger.error(`[Project] [lint] Failed for “${doc.uri}” #${doc.version}`, e);
         }
-        return result;
     }
-    async ensureParsedAndCheckedOnlyWhenReady(uri) {
-        const result = await this.ensureParsed(uri);
-        if (__classPrivateFieldGet(this, _Project_isReady, "f") && result) {
-            await this.ensureChecked(result.doc, result.node);
+    // @SingletonPromise()
+    async ensureBindingStarted(uri) {
+        if (this.#symbolUpToDateUris.has(uri) || this.#bindingInProgressUris.has(uri)) {
+            return;
         }
-        return result;
+        this.#bindingInProgressUris.add(uri);
+        const doc = await this.read(uri);
+        if (!doc || !(await this.cacheService.hasFileChangedSinceCache(doc))) {
+            return;
+        }
+        const node = this.parse(doc);
+        await this.bind(doc, node);
+        this.emit('documentUpdated', { doc, node });
     }
-    bind(param) {
-        const ctx = Context_1.UriBinderContext.create(this);
+    bindUri(param) {
+        const ctx = UriBinderContext.create(this);
         if (typeof param === 'string') {
             ctx.symbols.clear({ contributor: 'uri_binder', uri: param });
         }
@@ -545,45 +596,74 @@ class Project extends events_1.default {
     /**
      * Notify that a new document was opened in the editor.
      */
-    onDidOpen(uri, languageID, version, content) {
-        uri = fileUtil_1.fileUtil.normalize(uri);
-        __classPrivateFieldGet(this, _Project_clientManagedUris, "f").add(uri);
-        const doc = vscode_languageserver_textdocument_1.TextDocument.create(uri, languageID, version, content);
-        const { node } = this.parseAndCache(doc);
-        if (__classPrivateFieldGet(this, _Project_isReady, "f")) {
-            this.check(doc, node);
+    async onDidOpen(uri, languageID, version, content) {
+        uri = this.normalizeUri(uri);
+        if (!fileUtil.isFileUri(uri)) {
+            return; // We only accept `file:` scheme for client-managed URIs.
+        }
+        const doc = TextDocument.create(uri, languageID, version, content);
+        const node = this.parse(doc);
+        this.#clientManagedUris.add(uri);
+        this.#clientManagedDocAndNodes.set(uri, { doc, node });
+        if (this.#isReady) {
+            await this.bind(doc, node);
+            await this.check(doc, node);
         }
     }
     /**
      * Notify that an existing document was changed in the editor.
      * @throws If there is no `TextDocument` corresponding to the URI.
      */
-    onDidChange(uri, changes, version) {
-        uri = fileUtil_1.fileUtil.normalize(uri);
-        const result = this.get(uri);
-        if (!result) {
-            throw new Error(`Document for “${uri}” is not cached. This should not happen. Did the language client send a didChange notification without sending a didOpen one?`);
+    async onDidChange(uri, changes, version) {
+        this.#symbolUpToDateUris.delete(uri);
+        uri = this.normalizeUri(uri);
+        if (!fileUtil.isFileUri(uri)) {
+            return; // We only accept `file:` scheme for client-managed URIs.
         }
-        vscode_languageserver_textdocument_1.TextDocument.update(result.doc, changes, version);
-        const { node } = this.parseAndCache(result.doc);
-        if (__classPrivateFieldGet(this, _Project_isReady, "f")) {
-            this.check(result.doc, node);
+        const doc = this.#clientManagedDocAndNodes.get(uri)?.doc;
+        if (!doc) {
+            throw new Error(`TextDocument for “${uri}” is ${!doc ? 'not cached' : 'a Promise'}. This should not happen. Did the language client send a didChange notification without sending a didOpen one, or is there a logic error on our side resulting the 'read' function overriding the 'TextDocument' created in the 'didOpen' notification handler?`);
+        }
+        TextDocument.update(doc, changes, version);
+        const node = this.parse(doc);
+        this.#clientManagedDocAndNodes.set(uri, { doc, node });
+        if (this.#isReady) {
+            await this.bind(doc, node);
+            await this.check(doc, node);
         }
     }
     /**
      * Notify that an existing document was closed in the editor.
      */
     onDidClose(uri) {
-        uri = fileUtil_1.fileUtil.normalize(uri);
-        __classPrivateFieldGet(this, _Project_clientManagedUris, "f").delete(uri);
+        uri = this.normalizeUri(uri);
+        if (!fileUtil.isFileUri(uri)) {
+            return; // We only accept `file:` scheme for client-managed URIs.
+        }
+        this.#clientManagedUris.delete(uri);
+        this.#clientManagedDocAndNodes.delete(uri);
         this.tryClearingCache(uri);
     }
+    async ensureClientManagedChecked(uri) {
+        const result = this.#clientManagedDocAndNodes.get(uri);
+        if (result && this.#isReady) {
+            const { doc, node } = result;
+            await this.bind(doc, node);
+            await this.check(doc, node);
+            this.emit('documentUpdated', { doc, node });
+            return { doc, node };
+        }
+        return undefined;
+    }
+    getClientManaged(uri) {
+        return this.#clientManagedDocAndNodes.get(uri);
+    }
     async showCacheRoot() {
-        if (!__classPrivateFieldGet(this, _Project_cacheRoot, "f")) {
+        if (!this.#cacheRoot) {
             return;
         }
         try {
-            await fileUtil_1.fileUtil.showFile(__classPrivateFieldGet(this, _Project_cacheRoot, "f"));
+            await this.externals.fs.showFile(this.#cacheRoot);
         }
         catch (e) {
             this.logger.error('[Service#showCacheRoot]', e);
@@ -591,33 +671,24 @@ class Project extends events_1.default {
     }
     tryClearingCache(uri) {
         if (this.shouldRemove(uri)) {
-            __classPrivateFieldGet(this, _Project_docAndNodes, "f").delete(uri);
+            this.removeCachedTextDocument(uri);
             this.emit('documentRemoved', { uri });
         }
     }
     shouldRemove(uri) {
-        return !__classPrivateFieldGet(this, _Project_clientManagedUris, "f").has(uri) && !__classPrivateFieldGet(this, _Project_dependencyFiles, "f").has(uri) && !__classPrivateFieldGet(this, _Project_watchedFiles, "f").has(uri);
+        return !this.#clientManagedUris.has(uri) && !this.#dependencyFiles.has(uri) && !this.#watchedFiles.has(uri);
     }
     isOnlyWatched(uri) {
-        return __classPrivateFieldGet(this, _Project_watchedFiles, "f").has(uri) && !__classPrivateFieldGet(this, _Project_clientManagedUris, "f").has(uri) && !__classPrivateFieldGet(this, _Project_dependencyFiles, "f").has(uri);
+        return this.#watchedFiles.has(uri) && !this.#clientManagedUris.has(uri) && !this.#dependencyFiles.has(uri);
     }
 }
-_Project_cacheSaverIntervalId = new WeakMap(), _Project_clientManagedUris = new WeakMap(), _Project_configService = new WeakMap(), _Project_docAndNodes = new WeakMap(), _Project_initializers = new WeakMap(), _Project_initPromise = new WeakMap(), _Project_readyPromise = new WeakMap(), _Project_watchedFiles = new WeakMap(), _Project_watcher = new WeakMap(), _Project_watcherReady = new WeakMap(), _Project_isReady = new WeakMap(), _Project_dependencyRoots = new WeakMap(), _Project_dependencyFiles = new WeakMap(), _Project_roots = new WeakMap(), _Project_ctx = new WeakMap(), _Project_cacheRoot = new WeakMap();
-Project.RootSuffix = '/pack.mcmeta';
 __decorate([
-    (0, common_1.CachePromise)()
-], Project.prototype, "ensureParsed", null);
+    SingletonPromise()
+], Project.prototype, "bind", null);
 __decorate([
-    (0, common_1.CachePromise)()
+    SingletonPromise()
 ], Project.prototype, "check", null);
 __decorate([
-    (0, common_1.CachePromise)()
-], Project.prototype, "ensureChecked", null);
-__decorate([
-    (0, common_1.CachePromise)()
-], Project.prototype, "ensureParsedAndChecked", null);
-__decorate([
-    (0, common_1.CachePromise)()
-], Project.prototype, "ensureParsedAndCheckedOnlyWhenReady", null);
-exports.Project = Project;
+    SingletonPromise()
+], Project.prototype, "ensureClientManagedChecked", null);
 //# sourceMappingURL=Project.js.map