@hydranium/core 1.0.0-next.10

package/lib/langium/project/abstract-project-manager.js

@@ -0,0 +1,545 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import { Deferred, UNQUALIFIED_PROJECT_REFERENCE } from '@hydranium/protocol';
+import { AstUtils, UriUtils } from '@hydranium/langium';
+import { Disposable } from 'vscode-languageserver';
+import { isVirtualUri } from '../workspace/virtual-document.js';
+/**
+ * Abstract base for project-aware {@link ProjectManager} implementations.
+ * Implements the machinery: registry, auto-subscription to
+ * `DocumentBuilder.onUpdate`, event channel, cascade computation, and
+ * change-emission.
+ *
+ * Consumers extend this and override only the hooks specific to their
+ * project model. For the no-project case, bind `SingleProjectManager`
+ * instead — it implements {@link ProjectManager} directly with a single
+ * synthetic project that owns every URI.
+ *
+ * ## Required overrides
+ *
+ * - {@link isProjectDescriptor} — abstract; predicate identifying the
+ *   consumer's descriptor files.
+ * - {@link parseProjectDescriptor} — abstract; converts a parsed
+ *   descriptor document into a {@link Project}.
+ *
+ * ## Optional overrides
+ *
+ * - {@link findDescriptorUris} — default walks the workspace folders
+ *   recursively. Override to use a manifest index, glob pattern, or
+ *   explicit listing.
+ * - {@link shouldEnterDirectory} — default skips hidden directories,
+ *   `node_modules`, and `out`. Override to customise exclusion rules
+ *   without re-implementing the walk.
+ * - {@link getAffectedProjects} — default walks {@link Project.dependencies}
+ *   transitively in reverse (projects whose dep closure touches a changed
+ *   project also rebuild). Override for a different rebuild policy.
+ * - {@link getVisibleProjects} — default walks {@link Project.dependencies}
+ *   transitively. Override for a different visibility model.
+ * - {@link computeProject} — default uses closest-ancestor-descriptor-folder
+ *   membership. Override for a different membership model; overriding
+ *   {@link getProject} instead loses the memoization it wraps.
+ */
+export class AbstractProjectManager {
+    services;
+    /** Project id → {@link Project}. */
+    projects = new Map();
+    /** Descriptor URI (`uri.toString()`) → project id. Drives {@link getProject} membership lookups. */
+    projectByDescriptor = new Map();
+    /** Descriptor URI → owning folder URI (cached for efficient closest-ancestor lookups). */
+    descriptorDirectories = new Map();
+    /**
+     * Memoized {@link getProject} results, keyed by URI string (`undefined` = no owning project,
+     * distinguished from a cache miss by {@link Map.has}). Membership resolution is a hot path —
+     * called per description / node / reference during a build — but the descriptor set only
+     * changes on a project rebuild, so the result is stable between rebuilds. Cleared by
+     * {@link invalidateMembershipCache} wherever the descriptor maps mutate.
+     */
+    membershipCache = new Map();
+    listeners = [];
+    readyDeferred = new Deferred();
+    discoveryRan = false;
+    fileSystemProvider;
+    langiumDocuments;
+    documentBuilder;
+    tracer;
+    constructor(services, options = {}) {
+        this.services = services;
+        this.fileSystemProvider = services.workspace.FileSystemProvider;
+        this.langiumDocuments = services.workspace.LangiumDocuments;
+        this.documentBuilder = services.workspace.DocumentBuilder;
+        this.tracer = services.Tracer.for(options.logName ?? this.constructor.name).trace('instantiated');
+        this.documentBuilder.onUpdate((changed, deleted) => this.onBuildUpdate(changed, deleted));
+    }
+    get ready() {
+        return this.readyDeferred.promise;
+    }
+    onProjectsChanged(listener) {
+        this.listeners.push(listener);
+        return Disposable.create(() => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0) {
+                this.listeners.splice(idx, 1);
+            }
+        });
+    }
+    /**
+     * Whether `uri` should be tracked as a project descriptor. Enforces the
+     * framework invariant that a **virtual document** (no backing file, a
+     * `virtual:` URI) can never be a descriptor — a contributed stdlib / library
+     * document whose URI happens to match a broad adopter
+     * {@link isProjectDescriptor} predicate must not spawn a phantom
+     * project — then defers to the adopter predicate. Every descriptor gate
+     * (initial walk + incremental {@link onBuildUpdate}) routes through here, so
+     * the invariant holds for all adopters without each having to guard it.
+     */
+    isDescriptorUri(uri) {
+        return !isVirtualUri(uri) && this.isProjectDescriptor(uri);
+    }
+    /**
+     * Default implementation: `true` iff the owning project's
+     * {@link Project.referenceName} equals {@link UNQUALIFIED_PROJECT_REFERENCE},
+     * or `uri` is not owned by any project. Subclasses with cheaper
+     * lookups override.
+     */
+    isUnqualifiedProjectReference(uri) {
+        const project = this.getProject(uri);
+        return project === undefined || project.referenceName === UNQUALIFIED_PROJECT_REFERENCE;
+    }
+    /**
+     * Adopter-facing concept name used in the change-log lines this manager
+     * emits ({@link logProjectChange}). Default `'project'`; adopters override
+     * to their own domain term.
+     */
+    conceptName() {
+        return 'project';
+    }
+    /**
+     * Emit an `Add/Update` / `Remove` change-log line for a project. `uri` is the
+     * descriptor file; its workspace-relative path is shown via the
+     * `HydraniumWorkspaceManager` the framework binds. `info`-level, so it
+     * is suppressed when the log threshold is above `info`.
+     */
+    logProjectChange(action, id, uri) {
+        const location = this.services.workspace.WorkspaceManager.wsRelativePath(uri);
+        this.tracer.info(`${action} ${this.conceptName()} "${id}" from ${location}`);
+    }
+    /**
+     * Default implementation: returns `true` while the registry holds at
+     * most one project. Conservative — flips to `false` as soon as a
+     * second project is registered, even if all documents still belong
+     * to the first. Subclasses with a richer notion of "meaningful
+     * project boundary" override.
+     */
+    isSingleProject() {
+        return this.getProjects().length <= 1;
+    }
+    /**
+     * Locate descriptor URIs across the given workspace folders. Default
+     * walks recursively via {@link fileSystemProvider}, respecting
+     * {@link shouldEnterDirectory} for folder exclusions. Override to use
+     * a manifest index, glob, or explicit listing.
+     */
+    async findDescriptorUris(folders) {
+        const result = [];
+        for (const folder of folders) {
+            await this.walkForDescriptors(UriUtils.toUri(folder.uri), result);
+        }
+        return result;
+    }
+    /**
+     * Recursive helper for the default {@link findDescriptorUris}. Override
+     * to customise traversal *behaviour*; override {@link shouldEnterDirectory}
+     * if only the directory-exclusion rule needs to change.
+     */
+    async walkForDescriptors(folder, accumulator) {
+        let entries;
+        try {
+            entries = await this.fileSystemProvider.readDirectory(folder);
+        }
+        catch (error) {
+            this.tracer.warn(`Failed to read directory ${folder.toString()}: ${error}`);
+            return;
+        }
+        for (const entry of entries) {
+            const name = UriUtils.basename(entry.uri);
+            if (entry.isDirectory) {
+                if (this.shouldEnterDirectory(entry.uri, name)) {
+                    await this.walkForDescriptors(entry.uri, accumulator);
+                }
+            }
+            else if (entry.isFile && this.isDescriptorUri(entry.uri)) {
+                accumulator.push(entry.uri);
+            }
+        }
+    }
+    /**
+     * Predicate controlling whether the default descriptor walk descends
+     * into a sub-directory. Default skips hidden directories
+     * (`name.startsWith('.')`), `node_modules`, and `out` — the common
+     * "ignore build outputs and tooling" rules. Override to tighten or
+     * loosen the set without re-implementing the recursion.
+     */
+    shouldEnterDirectory(_uri, name) {
+        if (name.startsWith('.')) {
+            return false;
+        }
+        return name !== 'node_modules' && name !== 'out';
+    }
+    /**
+     * Compute the set of projects whose member documents need to rebuild
+     * given the directly changed projects. Default walks the dependency
+     * graph in reverse — any project whose declared {@link Project.dependencies}
+     * include a changed id transitively also rebuilds (cycle-safe).
+     *
+     * Override for a different rebuild policy (no transitivity, custom
+     * reachability, etc.).
+     */
+    getAffectedProjects(directlyChanged) {
+        const result = new Set(directlyChanged);
+        let grew = true;
+        while (grew) {
+            grew = false;
+            for (const project of this.projects.values()) {
+                if (result.has(project.id)) {
+                    continue;
+                }
+                if (project.dependencies?.some(dep => result.has(dep))) {
+                    result.add(project.id);
+                    grew = true;
+                }
+            }
+        }
+        return [...result];
+    }
+    /**
+     * Whether replacing `previous` with `updated` — the same project re-parsed
+     * (both carry the same {@link Project.id}) — forces the project's member
+     * documents, and via {@link getAffectedProjects} its dependents, to
+     * rebuild. Consulted only on the same-id update path; an id change is
+     * handled as remove-old + add-new and always rebuilds.
+     *
+     * The default compares the fields the framework itself reads when building
+     * or linking members: {@link Project.referenceName} (the prefix
+     * cross-project qualified names resolve against) and
+     * {@link Project.dependencies} (the visibility closure). It intentionally
+     * ignores {@link Project.version} — the framework never reads it (it is
+     * pass-through client metadata), so a version-only change still emits an
+     * `updated` event but rebuilds nothing.
+     *
+     * Override to widen the comparison with adopter descriptor fields that a
+     * member build observes, combining with `super.requiresMemberRebuild(...)`.
+     */
+    requiresMemberRebuild(previous, updated) {
+        return previous.referenceName !== updated.referenceName || !sameDependencies(previous, updated);
+    }
+    /**
+     * Default: transitive closure of {@link Project.dependencies} including
+     * the source project itself. Override for a different visibility model.
+     */
+    getVisibleProjects(projectId) {
+        if (!this.projects.has(projectId)) {
+            return [];
+        }
+        const visited = new Set();
+        const ordered = [];
+        this.collectVisibleProjects(projectId, visited, ordered);
+        return ordered;
+    }
+    isVisible(sourceProjectId, targetProjectId, selfVisible = false) {
+        const visible = this.getVisibleProjects(sourceProjectId);
+        if (visible.length === 0) {
+            return false;
+        }
+        if (sourceProjectId === targetProjectId) {
+            return selfVisible;
+        }
+        return visible.includes(targetProjectId);
+    }
+    collectVisibleProjects(projectId, visited, ordered) {
+        if (visited.has(projectId)) {
+            return;
+        }
+        visited.add(projectId);
+        const project = this.projects.get(projectId);
+        if (!project) {
+            return;
+        }
+        ordered.push(projectId);
+        if (project.dependencies) {
+            for (const dep of project.dependencies) {
+                this.collectVisibleProjects(dep, visited, ordered);
+            }
+        }
+    }
+    // ============================================================
+    // Discovery
+    // ============================================================
+    async discoverProjects(folders) {
+        if (this.discoveryRan) {
+            this.tracer.warn('discoverProjects called more than once — ignoring subsequent call.');
+            return;
+        }
+        this.discoveryRan = true;
+        const descriptorUris = await this.findDescriptorUris(folders);
+        const added = [];
+        for (const uri of descriptorUris) {
+            const project = await this.loadDescriptor(uri);
+            if (project) {
+                added.push(project.id);
+            }
+        }
+        this.readyDeferred.resolve();
+        if (added.length > 0) {
+            this.emit({ added, updated: [], removed: [], affectedDocuments: [] });
+        }
+    }
+    /**
+     * Parse a single descriptor URI and register the resulting project.
+     * Returns the parsed project, or `undefined` if parsing failed (errors
+     * are logged, not thrown — the rest of discovery / update continues).
+     */
+    async loadDescriptor(uri) {
+        try {
+            const document = await this.langiumDocuments.getOrCreateDocument(uri);
+            const project = await this.parseProjectDescriptor(uri, document);
+            if (project) {
+                this.projects.set(project.id, project);
+                this.projectByDescriptor.set(uri.toString(), project.id);
+                this.descriptorDirectories.set(uri.toString(), UriUtils.dirname(uri));
+                this.invalidateMembershipCache();
+                this.logProjectChange('Add/Update', project.id, uri);
+            }
+            return project;
+        }
+        catch (error) {
+            this.tracer.error(`Failed to parse ${this.conceptName()} descriptor at ${uri.toString()}: ${error}`);
+            return undefined;
+        }
+    }
+    // ============================================================
+    // Incremental update
+    // ============================================================
+    /**
+     * Handle a `DocumentBuilder.onUpdate` event. Filters for descriptor
+     * URIs, diffs the registry, and emits {@link ProjectChangeEvent} with
+     * the registry diff plus the affected documents that need rebuilding.
+     *
+     * Descriptor URIs that triggered the cycle are excluded from
+     * {@link ProjectChangeEvent.affectedDocuments} — re-adding them would
+     * loop.
+     */
+    async onBuildUpdate(changed, deleted) {
+        const changedDescriptors = changed.filter(uri => this.isDescriptorUri(uri));
+        const deletedDescriptors = deleted.filter(uri => this.isDescriptorUri(uri));
+        if (changedDescriptors.length === 0 && deletedDescriptors.length === 0) {
+            return;
+        }
+        // Descriptor removals below mutate the maps `computeProject` reads; drop the
+        // memoized results now (adds also re-clear via `loadDescriptor`), so the
+        // `getProject` calls in `collectAffectedDocuments` see the post-change state.
+        this.invalidateMembershipCache();
+        // Note: we intentionally do NOT await `ready` here. In the production
+        // flow `discoverProjects` completes (resolving `ready`) inside
+        // `HydraniumWorkspaceManager.performStartup` before `documentBuilder.build`
+        // runs, so the registry is already populated by the time `onUpdate`
+        // fires. Awaiting would deadlock test scenarios that exercise
+        // `parseDocument` directly without going through workspace startup.
+        const added = [];
+        const updated = [];
+        const removed = [];
+        // Ids whose member documents must rebuild. Added and removed projects
+        // always qualify; an updated project only when a member-observable field
+        // changed (see requiresMemberRebuild) — a metadata-only change still
+        // emits an `updated` event but drives no member rebuild.
+        const rebuildIds = [];
+        for (const uri of changedDescriptors) {
+            const uriStr = uri.toString();
+            const previousProjectId = this.projectByDescriptor.get(uriStr);
+            const previousProject = previousProjectId ? this.projects.get(previousProjectId) : undefined;
+            const newProject = await this.loadDescriptor(uri);
+            if (newProject) {
+                if (!previousProjectId) {
+                    added.push(newProject.id);
+                    rebuildIds.push(newProject.id);
+                }
+                else if (previousProjectId !== newProject.id) {
+                    // Descriptor file now describes a different project id — treat
+                    // as remove-old + add-new so dependents on the old id can react.
+                    this.projects.delete(previousProjectId);
+                    if (previousProject) {
+                        removed.push({ id: previousProjectId, snapshot: previousProject });
+                        this.logProjectChange('Remove', previousProjectId, uri);
+                    }
+                    added.push(newProject.id);
+                    rebuildIds.push(newProject.id);
+                }
+                else {
+                    updated.push(newProject.id);
+                    if (!previousProject || this.requiresMemberRebuild(previousProject, newProject)) {
+                        rebuildIds.push(newProject.id);
+                    }
+                }
+            }
+            else if (previousProjectId) {
+                // Descriptor parsed before but now invalid — drop it.
+                this.projects.delete(previousProjectId);
+                this.projectByDescriptor.delete(uriStr);
+                this.descriptorDirectories.delete(uriStr);
+                if (previousProject) {
+                    removed.push({ id: previousProjectId, snapshot: previousProject });
+                    this.logProjectChange('Remove', previousProjectId, uri);
+                }
+            }
+        }
+        for (const uri of deletedDescriptors) {
+            const uriStr = uri.toString();
+            const projectId = this.projectByDescriptor.get(uriStr);
+            if (projectId) {
+                const snapshot = this.projects.get(projectId);
+                this.projects.delete(projectId);
+                this.projectByDescriptor.delete(uriStr);
+                this.descriptorDirectories.delete(uriStr);
+                if (snapshot) {
+                    removed.push({ id: projectId, snapshot });
+                    this.logProjectChange('Remove', projectId, uri);
+                }
+            }
+        }
+        if (added.length === 0 && updated.length === 0 && removed.length === 0) {
+            return;
+        }
+        const removedIds = removed.map(entry => entry.id);
+        const affectedProjectIds = new Set(this.getAffectedProjects([...rebuildIds, ...removedIds]));
+        const excluded = new Set();
+        for (const uri of changedDescriptors) {
+            excluded.add(uri.toString());
+        }
+        for (const uri of deletedDescriptors) {
+            excluded.add(uri.toString());
+        }
+        const affectedDocuments = this.collectAffectedDocuments(affectedProjectIds, excluded);
+        this.emit({ added, updated, removed, affectedDocuments });
+    }
+    /** Iterate the document set once, collecting URIs whose owning project is in the affected set. */
+    collectAffectedDocuments(affectedProjectIds, excludedUris) {
+        const result = [];
+        for (const document of this.langiumDocuments.all) {
+            const uriStr = document.uri.toString();
+            if (excludedUris.has(uriStr)) {
+                continue;
+            }
+            const owning = this.getProject(document.uri);
+            if (owning && affectedProjectIds.has(owning.id)) {
+                result.push(document.uri);
+            }
+        }
+        return result;
+    }
+    // ============================================================
+    // Queries
+    // ============================================================
+    /**
+     * The project owning the given URI, memoized per URI (see {@link membershipCache}).
+     * The membership computation lives in {@link computeProject} — override THAT, not
+     * this, so a subclass's custom model inherits the memoization + invalidation.
+     */
+    getProject(uri) {
+        const target = UriUtils.toUri(uri);
+        const targetStr = target.toString();
+        if (this.membershipCache.has(targetStr)) {
+            return this.membershipCache.get(targetStr);
+        }
+        const result = this.computeProject(target);
+        this.membershipCache.set(targetStr, result);
+        return result;
+    }
+    /**
+     * Compute the project owning {@link target} — default: the project whose descriptor
+     * directory is the closest ancestor. Subclasses override for a different membership
+     * model; the result is memoized by {@link getProject}.
+     *
+     * The lookup is O(N) in the number of registered projects per call, but memoization
+     * collapses the repeated per-description / per-node calls to one per URI per rebuild.
+     * Subclasses that additionally need O(1) per unique URI can maintain a reverse index.
+     */
+    computeProject(target) {
+        // Direct hit on a descriptor URI is the owning project itself.
+        const directProjectId = this.projectByDescriptor.get(target.toString());
+        if (directProjectId) {
+            return this.projects.get(directProjectId);
+        }
+        // Otherwise, find the closest-ancestor descriptor directory.
+        let bestDescriptorUri;
+        let bestLength = -1;
+        for (const [descriptorUri, directory] of this.descriptorDirectories) {
+            if (UriUtils.isAncestorOrEqual(directory, target) && directory.fsPath.length > bestLength) {
+                bestDescriptorUri = descriptorUri;
+                bestLength = directory.fsPath.length;
+            }
+        }
+        if (!bestDescriptorUri) {
+            return undefined;
+        }
+        const projectId = this.projectByDescriptor.get(bestDescriptorUri);
+        return projectId ? this.projects.get(projectId) : undefined;
+    }
+    /** Drop all memoized membership results. Called wherever the descriptor maps mutate. */
+    invalidateMembershipCache() {
+        this.membershipCache.clear();
+    }
+    getProjectForNode(node) {
+        const uri = AstUtils.findRootNode(node).$document?.uri;
+        return uri ? this.getProject(uri) : undefined;
+    }
+    getProjectById(id) {
+        return this.projects.get(id);
+    }
+    getProjects() {
+        return Array.from(this.projects.values());
+    }
+    getProjectUris(projectId) {
+        if (!this.projects.has(projectId)) {
+            return [];
+        }
+        const result = [];
+        for (const document of this.langiumDocuments.all) {
+            if (this.getProject(document.uri)?.id === projectId) {
+                result.push(document.uri);
+            }
+        }
+        return result;
+    }
+    // ============================================================
+    // Event emission
+    // ============================================================
+    emit(event) {
+        // Copy the listener list so a listener registering or disposing
+        // during iteration doesn't mutate the array we're walking.
+        const snapshot = this.listeners.slice();
+        for (const listener of snapshot) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                this.tracer.error(`Project change listener failed: ${error}`);
+            }
+        }
+    }
+}
+/** Order-independent equality of two projects' dependency id sets. */
+function sameDependencies(a, b) {
+    const previous = a.dependencies ?? [];
+    const next = b.dependencies ?? [];
+    if (previous.length !== next.length) {
+        return false;
+    }
+    const nextSet = new Set(next);
+    return previous.every(dep => nextSet.has(dep));
+}
+//# sourceMappingURL=abstract-project-manager.js.map

package/lib/langium/project/abstract-project-manager.js.map

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

package/lib/langium/project/index.d.ts

@@ -0,0 +1,13 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './abstract-project-manager.js';
+export * from './project-change-event.js';
+export * from './project-manager.js';
+export * from './single-project-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/langium/project/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/langium/project/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC"}

package/lib/langium/project/index.js

@@ -0,0 +1,13 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+export * from './abstract-project-manager.js';
+export * from './project-change-event.js';
+export * from './project-manager.js';
+export * from './single-project-manager.js';
+//# sourceMappingURL=index.js.map

package/lib/langium/project/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/langium/project/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC"}

package/lib/langium/project/project-change-event.d.ts

@@ -0,0 +1,64 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import type { Project } from '@hydranium/protocol';
+import type { URI } from '@hydranium/langium';
+/**
+ * Event emitted by `ProjectManager.onProjectsChanged` when the project
+ * registry diffs after a workspace update. Reports both the registry-level
+ * diff (which projects appeared / changed / disappeared) and the document-
+ * level fallout (which documents need to rebuild because their reachable
+ * scope changed).
+ *
+ * - {@link added} / {@link updated} carry **project ids**, not {@link Project}
+ *   objects. The full {@link Project} can be retrieved via
+ *   `ProjectManager.getProjectById`.
+ * - {@link removed} carries **{ id, snapshot }** pairs — by the time the event
+ *   fires the registry has already cleared the project, so each entry bundles
+ *   the id with the pre-removal snapshot so consumers can read the project's
+ *   metadata (version, dependencies, plus any subclass-extended fields)
+ *   without maintaining their own shadow registry.
+ * - {@link affectedDocuments} lists URIs whose reachable scope changed. The
+ *   default cascade plumbing in `HydraniumWorkspaceManager` subscribes to
+ *   this event and re-runs `DocumentBuilder.resetToState` for each entry,
+ *   which the next build cycle picks up. Consumers can subscribe
+ *   independently for other reactions.
+ */
+export interface ProjectChangeEvent<TProject extends Project = Project> {
+    /** Ids of projects newly registered since the last event. */
+    readonly added: readonly string[];
+    /**
+     * Ids of projects re-parsed from a changed descriptor that kept the same
+     * id. A descriptor that now names a *different* id is reported as a
+     * removal of the old id plus an addition of the new one, never here.
+     */
+    readonly updated: readonly string[];
+    /**
+     * Projects no longer in the registry, paired with their pre-removal
+     * snapshot. The id and snapshot are bundled per-entry so consumers
+     * never need to zip parallel arrays by index.
+     */
+    readonly removed: ReadonlyArray<{
+        readonly id: string;
+        readonly snapshot: TProject;
+    }>;
+    /**
+     * Documents whose reachable scope changed and therefore need to
+     * rebuild. Includes the changed projects' own member documents plus
+     * any transitive dependents according to the concrete
+     * `ProjectManager`'s visibility model (see
+     * `AbstractProjectManager.getAffectedProjects`).
+     *
+     * Descriptor URIs themselves are intentionally excluded: they triggered
+     * this cycle and re-adding them would loop.
+     */
+    readonly affectedDocuments: readonly URI[];
+}
+/** Callback shape for `ProjectManager.onProjectsChanged`. */
+export type ProjectChangeListener<TProject extends Project = Project> = (event: ProjectChangeEvent<TProject>) => void;
+//# sourceMappingURL=project-change-event.d.ts.map