@hydranium/core 1.0.0-next.39 → 1.0.0-next.390

package/lib/langium/model-service/client-session.js

@@ -0,0 +1,479 @@
+/********************************************************************************
+ * 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 { ConflictError, isModelVersion, Logger, ObservableValue, describeErrorWithStack } from '@hydranium/protocol';
+import { isOperationCancelled, UriUtils } from '@hydranium/langium';
+import { Emitter } from 'vscode-languageserver';
+import { DocumentNotOpenError, DocumentSyntaxError, SessionClosedError } from '../../documents/client-session-errors.js';
+import { hasSkippedText } from '../workspace/syntax-errors.js';
+/**
+ * The framework's {@link ClientSession}, built by
+ * {@link DefaultClientSessionFactory}.
+ *
+ * Override the protected method behind a member to change how every session
+ * writes, and return the subclass from a {@link ClientSessionFactory} bound on
+ * `model.ClientSessionFactory`. Serialising a model and rebuilding a document
+ * are the {@link ModelService}'s.
+ *
+ * An override of {@link dispose} calls `super.dispose(cause)`: that is what
+ * closes the session's opens and frees its id, and dropping `cause` reverts
+ * a lost client's documents without their grace.
+ */
+export class DefaultClientSession {
+    services;
+    disposed = false;
+    /**
+     * This session's opens still under way, by canonical URI. Recorded before
+     * the first await, so a second open of the same URI joins the first rather
+     * than racing it, and `withOpen` can tell an open another call is making.
+     */
+    pendingOpens = new Map();
+    /**
+     * The options of this session's opens, by canonical URI. A first open
+     * records its entry before the store has the URI open, and the entry goes
+     * when that open closes, whoever ends it: this session, or the store for a
+     * deleted file. A first open that fails never opens, so nothing closes it
+     * and its entry stays until the next first open of the URI overwrites it;
+     * {@link openOptions} therefore reads an entry only while the store has the
+     * URI open for this session.
+     */
+    openOptionsByUri = new Map();
+    /** Drops an open's options from {@link openOptionsByUri} when the store closes the open. */
+    closeListener;
+    disposeEmitter = new Emitter();
+    /** Logs under `logName`, `ClientSession` when none is given, with this session's id in a bracket of its own, so a line names the session that wrote. */
+    tracer;
+    /** The service bound on `model.ModelService`, which serialises and rebuilds for this session. */
+    modelService;
+    /** See {@link ClientSessionFactoryOptions.slowUpdateWarnMs}; `undefined` when not set. */
+    slowUpdateWarn;
+    clientId;
+    label;
+    constructor(services, options) {
+        this.services = services;
+        this.clientId = options.clientId;
+        this.label = options.label ?? options.clientId;
+        // The slot is shared across grammars; this session's types hold for the
+        // grammar that started it, as `createSession`'s narrowing does.
+        this.modelService = services.model.ModelService;
+        this.slowUpdateWarn = options.slowUpdateWarnMs !== undefined ? ObservableValue.from(options.slowUpdateWarnMs) : undefined;
+        this.tracer = services.Tracer.for(options.logName ?? 'ClientSession').with(this.clientId);
+        this.closeListener = services.workspace.TextDocuments.onDidClose(event => {
+            if (event.clientId === this.clientId) {
+                this.openOptionsByUri.delete(event.document.uri);
+            }
+        });
+    }
+    open(uri, options) {
+        this.assertLive();
+        return this.openDocument(uri, options);
+    }
+    openOptions(uri) {
+        this.assertLive();
+        return this.services.workspace.TextDocuments.isOpenInClient(uri, this.clientId)
+            ? this.openOptionsByUri.get(this.canonicalKey(uri))
+            : undefined;
+    }
+    create(uri, text) {
+        this.assertLive();
+        return this.createDocument(uri, text);
+    }
+    update(args, cancelToken) {
+        this.assertLive();
+        return this.updateDocument(args, cancelToken);
+    }
+    updateAll(args, cancelToken) {
+        this.assertLive();
+        return this.updateDocuments(args, cancelToken);
+    }
+    save(args, cancelToken) {
+        this.assertLive();
+        return this.saveDocument(args, cancelToken);
+    }
+    persist(args) {
+        this.assertLive();
+        return this.persistDocument(args);
+    }
+    close(uri) {
+        this.assertLive();
+        return this.closeDocument(uri);
+    }
+    delete(args) {
+        this.assertLive();
+        return this.deleteDocument(args);
+    }
+    withOpen(uri, fn) {
+        this.assertLive();
+        return this.runWithOpen(uri, fn);
+    }
+    isOwnEcho(sourceClientId) {
+        this.assertLive();
+        return sourceClientId === this.clientId;
+    }
+    dispose(cause) {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.services.workspace.TextDocuments.closeSession(this.clientId, cause);
+        this.closeListener.dispose();
+        this.disposeEmitter.fire(cause ?? 'closed');
+        this.disposeEmitter.dispose();
+    }
+    get onDidDispose() {
+        return this.disposeEmitter.event;
+    }
+    assertLive() {
+        if (this.disposed) {
+            throw new SessionClosedError(this.clientId);
+        }
+    }
+    /** Throw `DocumentNotOpenError` unless this session has `uri` open and no delete of it is under way. */
+    assertOpen(uri) {
+        const workspace = this.services.workspace;
+        if (!workspace.TextDocuments.isOpenInClient(uri, this.clientId) || workspace.AstDocumentManager.isDeleting(uri)) {
+            throw new DocumentNotOpenError(uri, this.clientId);
+        }
+    }
+    /**
+     * Throw `ConflictError` when `baseVersion` names a version other than
+     * `currentVersion`. A write calls it at the door and again in the
+     * synchronous step that applies the text, and has to call it synchronously
+     * there: a check separated from the apply by an await lets two writes based
+     * on one version both apply.
+     */
+    assertBaseVersion(uri, baseVersion, currentVersion) {
+        if (isModelVersion(baseVersion) && currentVersion !== baseVersion) {
+            // Distinct from the post-build "superseded" debug line of an update: this
+            // is a stale-base-version rejection (the write never applies), not two
+            // writes racing.
+            this.tracer.debug(`Conflict on ${uri}: stale base, model v${baseVersion} / text v${currentVersion}`);
+            throw new ConflictError(uri, baseVersion, currentVersion);
+        }
+    }
+    /**
+     * Throw `DocumentSyntaxError` when the parse of `uri`'s last build lacks
+     * some of its text, see `hasSkippedText`. A write of a model calls it beside
+     * {@link assertBaseVersion}: the model is serialized over the whole text,
+     * and one read from such a document lacks what the parser skipped.
+     */
+    assertParses(uri) {
+        const document = this.modelService.getDocument(uri);
+        if (document && hasSkippedText(document)) {
+            throw new DocumentSyntaxError(uri);
+        }
+    }
+    /**
+     * Serialise `args.model`, apply it to the store under this session's id,
+     * rebuild, and resolve to the rebuilt document.
+     *
+     * The open check, the `baseVersion` gate and, for a model, the parse check
+     * run at the door, so a write that cannot land is refused before any
+     * adopter serialiser runs, and again in the synchronous step that applies
+     * the text: made only before the serialiser's await, a close during it
+     * lets the write land on a document this session no longer has open, and
+     * two writes based on one version both apply.
+     *
+     * Resolves with the latest build of the document, which may already carry
+     * a newer write; that is logged at debug, and a slow update at warn when
+     * `ClientSessionFactoryOptions.slowUpdateWarnMs` is set. It waits for the
+     * builder's final phase rather than the write's own build: a later write
+     * cancels that build, and the one that takes over validates the document
+     * after the answer was taken.
+     */
+    async updateDocument(args, cancelToken) {
+        const service = this.modelService;
+        const slowWarn = this.slowUpdateWarn && { threshold: this.slowUpdateWarn, stopwatch: this.services.Clock.stopwatch() };
+        const uri = this.canonicalKey(args.uri);
+        const profile = Logger.isLevelEnabled('debug') ? this.tracer.profile(`model-update ${uri}`) : undefined;
+        const run = async (stage, fn) => (profile ? profile.scope(stage, fn) : fn());
+        const textDocuments = this.services.workspace.TextDocuments;
+        const check = () => {
+            this.assertOpen(uri);
+            this.assertBaseVersion(uri, args.baseVersion, textDocuments.version(uri));
+            if (typeof args.model !== 'string' && !args.restore) {
+                this.assertParses(uri);
+            }
+        };
+        check();
+        service.assertCanBuild(uri);
+        const text = await run('serialize', () => service.modelToText(uri, args.model, cancelToken));
+        const appliedVersion = await run('apply', () => {
+            check();
+            return this.services.workspace.AstDocumentManager.update(uri, text, this.clientId);
+        });
+        // Through the public `rebuild`, so an override of it stays in the path.
+        // An override that awaits before calling the base can outlast the build
+        // this write already has, and then builds it twice; see
+        // `ModelService.rebuild`.
+        const doc = await run('rebuild', () => service.rebuild(uri, this.services.workspace.DocumentBuilder.finalBuildState(), cancelToken));
+        const finalVersion = textDocuments.version(uri);
+        if (finalVersion > appliedVersion) {
+            this.tracer.debug(`Update to v${appliedVersion} ready at v${finalVersion} (changed again before it settled)`);
+        }
+        else {
+            this.tracer.debug(`Update to v${appliedVersion} ready`);
+        }
+        if (slowWarn) {
+            const elapsed = Math.round(slowWarn.stopwatch.elapsedMs);
+            const threshold = slowWarn.threshold.value;
+            if (elapsed >= threshold) {
+                this.tracer.withUri(uri).warn(`Slow update: ${elapsed}ms ≥ ${threshold}ms (v${appliedVersion}, client=${this.clientId})`);
+            }
+        }
+        profile?.report('debug');
+        return { ...doc, written: { version: appliedVersion } };
+    }
+    /**
+     * Write every document of `args.updates`, all or none: every model is
+     * serialised first, then every open check, `baseVersion` gate and parse
+     * check runs and every text is applied in one synchronous step. Checked at
+     * the door as well, so a stale set is refused before any adopter serialiser
+     * runs.
+     *
+     * The apply step relies on `AstDocumentManager.update` applying its text
+     * before its first await, as the default does: an override that awaits first
+     * lets another write land between two documents of the set.
+     */
+    async updateDocuments(args, cancelToken) {
+        const service = this.modelService;
+        const { updates } = args;
+        const textDocuments = this.services.workspace.TextDocuments;
+        const uris = updates.map(update => this.canonicalKey(update.uri));
+        if (new Set(uris).size !== uris.length) {
+            throw new Error(`updateAll names a document more than once: ${uris.join(', ')}`);
+        }
+        const check = () => updates.forEach((update, i) => {
+            this.assertOpen(uris[i]);
+            this.assertBaseVersion(uris[i], update.baseVersion, textDocuments.version(uris[i]));
+            if (typeof update.model !== 'string' && !update.restore) {
+                this.assertParses(uris[i]);
+            }
+            service.assertCanBuild(uris[i]);
+        });
+        check();
+        const texts = [];
+        for (const [i, update] of updates.entries()) {
+            texts.push(await service.modelToText(uris[i], update.model, cancelToken));
+        }
+        // One synchronous step from the first check to the last apply: an await
+        // anywhere in it lets a close or another write land after its document
+        // was checked, and the set then half-applies before a later check fails.
+        check();
+        const applied = uris.map((uri, i) => this.services.workspace.AstDocumentManager.update(uri, texts[i], this.clientId));
+        const versions = await Promise.all(applied);
+        const state = this.services.workspace.DocumentBuilder.finalBuildState();
+        const rebuilt = await Promise.allSettled(uris.map(uri => service.rebuild(uri, state, cancelToken)));
+        const failures = rebuilt.flatMap((result, i) => (result.status === 'rejected' ? [{ uri: uris[i], reason: result.reason }] : []));
+        if (failures.length === 0) {
+            return rebuilt.flatMap((result, i) => result.status === 'fulfilled' ? [{ ...result.value, written: { version: versions[i] } }] : []);
+        }
+        // The first is thrown as it is, so a typed failure keeps its type; one build
+        // usually carries the set and fails each with the same error. Any other
+        // failure reaches no one else, so it is logged here.
+        const [{ uri: firstUri, reason: firstReason }] = failures;
+        for (const { uri, reason } of failures.slice(1)) {
+            if (isOperationCancelled(reason)) {
+                this.tracer.with(uri).debug(`Rebuild of ${uri} cancelled beside that of ${firstUri}`);
+            }
+            else if (reason !== firstReason) {
+                this.tracer.with(uri).error(`Rebuild of ${uri} failed beside that of ${firstUri}. ${describeErrorWithStack(reason)}`);
+            }
+        }
+        throw firstReason;
+    }
+    /**
+     * Write `args.model` through {@link updateDocument}, then persist it through
+     * {@link persistDocument}, so an override of either applies to saves too.
+     *
+     * Fails with `DocumentNotOpenError` and writes nothing when this session
+     * closes the URI while the text is being built. Persisted at `'any'`: the
+     * update already gated on `args.baseVersion` and moved the text past it.
+     * A `restore` in `args` is dropped: a save puts the model on disk, so
+     * it is always checked.
+     */
+    async saveDocument(args, cancelToken) {
+        const doc = await this.updateDocument({ ...args, restore: undefined }, cancelToken);
+        const version = await this.persistDocument({ uri: args.uri, baseVersion: 'any' });
+        return { ...doc, persisted: { version } };
+    }
+    /**
+     * Persist the store's text for `args.uri` under this session's id. Every
+     * write to disk a session makes goes through here, so an override sees each
+     * of them.
+     *
+     * The open check and the `baseVersion` gate sit in the same synchronous step
+     * as the manager taking the text: an await between them lets another
+     * client's write land after the gate, and its text is then persisted under
+     * this session's id without this session ever having seen it. An override
+     * that awaits before calling the base lets a diagram save take its
+     * documents' texts at different moments, and a diagram that ends during the
+     * await fails the documents not yet taken with `DocumentNotOpenError`.
+     */
+    async persistDocument(args) {
+        const uri = this.canonicalKey(args.uri);
+        this.assertOpen(uri);
+        this.assertBaseVersion(uri, args.baseVersion, this.services.workspace.TextDocuments.version(uri));
+        return this.services.workspace.AstDocumentManager.save(uri, this.clientId);
+    }
+    /**
+     * Delete `args.uri` under this session's id. The open check and the
+     * `baseVersion` gate sit in the same synchronous step as the manager's
+     * mark, which refuses every later write of the URI: an await between them
+     * lets another client's write land after the gate, and the delete then
+     * discards text this session never saw.
+     */
+    async deleteDocument(args) {
+        const uri = this.canonicalKey(args.uri);
+        this.assertOpen(uri);
+        this.assertBaseVersion(uri, args.baseVersion, this.services.workspace.TextDocuments.version(uri));
+        return this.services.workspace.AstDocumentManager.delete(uri, this.clientId);
+    }
+    async closeDocument(uri) {
+        await this.services.workspace.AstDocumentManager.close({ uri, clientId: this.clientId });
+    }
+    /** Open `uri`, or join the open of it this session already has under way, whose options then stand. */
+    openDocument(uri, options) {
+        const key = this.canonicalKey(uri);
+        const pending = this.pendingOpens.get(key);
+        if (pending) {
+            return pending;
+        }
+        const opening = this.registerOpen(uri, options).finally(() => {
+            if (this.pendingOpens.get(key) === opening) {
+                this.pendingOpens.delete(key);
+            }
+        });
+        this.pendingOpens.set(key, opening);
+        return opening;
+    }
+    /**
+     * Open `uri` in the store for this session. The open path does not thread
+     * cancellation: the file read behind it takes no token, so a cancelled
+     * caller still completes the open.
+     *
+     * A first open records its options before the store opens the URI, so a
+     * listener of the store's open reads this open's options rather than an
+     * earlier one's.
+     *
+     * It waits for the workspace first, as an LSP head's open does: a document
+     * opened before the bring-up links against a workspace that holds only
+     * itself, and the bring-up does not always relink it.
+     */
+    async registerOpen(uri, options) {
+        await this.modelService.ready;
+        // A session ended during the wait opens nothing.
+        this.assertLive();
+        const wasOpen = this.services.workspace.TextDocuments.isOpenInClient(uri, this.clientId);
+        if (!wasOpen) {
+            this.openOptionsByUri.set(this.canonicalKey(uri), options);
+        }
+        await this.services.workspace.AstDocumentManager.open({ uri, clientId: this.clientId });
+        await this.rejectIfEnded(uri, wasOpen);
+    }
+    canonicalKey(uri) {
+        return this.services.workspace.DocumentUriPolicy.canonicalUri(uri);
+    }
+    async createDocument(uri, text) {
+        // As `registerOpen` does, and before the checks, which read the workspace.
+        await this.modelService.ready;
+        if (await this.services.workspace.FileSystemProvider.exists(UriUtils.toUri(uri))) {
+            throw new Error(`Cannot create ${uri}: the file exists`);
+        }
+        this.assertLive();
+        if (this.services.workspace.TextDocuments.isReleaseDeferred(uri)) {
+            throw new Error(`Cannot create ${uri}: it holds the unsaved text of a lost client, waiting out the release grace`);
+        }
+        if (this.modelService.isOpen(uri)) {
+            throw new Error(`Cannot create ${uri}: it is open in a client`);
+        }
+        // The check above cannot see an open that registers while this one is
+        // under way, and opening an already-open URI only attaches, dropping
+        // `text`. Only an open that creates the document fires `onDidOpen`, so
+        // hearing it for this session, during this open, is what proves the
+        // document holds `text`; the client list afterwards cannot, since a
+        // client that registered first may have closed again by then.
+        const key = this.canonicalKey(uri);
+        let created;
+        const listener = this.services.workspace.TextDocuments.onDidOpen(event => {
+            if (event.clientId === this.clientId && event.document.uri === key) {
+                created = event.document.version;
+            }
+        });
+        try {
+            await this.services.workspace.AstDocumentManager.open({ uri, clientId: this.clientId, text });
+        }
+        finally {
+            listener.dispose();
+        }
+        await this.rejectIfEnded(uri, false);
+        if (created === undefined) {
+            await this.closeDocument(uri);
+            throw new Error(`Cannot create ${uri}: it is open in a client`);
+        }
+        return created;
+    }
+    async runWithOpen(uri, fn) {
+        // An open another call of this session is still making counts as made:
+        // closing it afterwards would take away an open that call asked for.
+        const alreadyOpen = this.services.workspace.TextDocuments.isOpenInClient(uri, this.clientId) || this.pendingOpens.has(this.canonicalKey(uri));
+        await this.openDocument(uri, undefined);
+        try {
+            return await fn();
+        }
+        finally {
+            if (!alreadyOpen && !this.disposed) {
+                await this.closeDocument(uri);
+            }
+        }
+    }
+    /**
+     * Undo an open that completed after the session ended, then fail it.
+     *
+     * Ending the session closed only what it had open at that moment. An open
+     * still reading from disk registers afterwards, under an id that is no
+     * longer a session, and nothing would ever close it.
+     *
+     * Opens are keyed by id, so once a new session holds the same id this open
+     * is indistinguishable from one of its own, and closing it would close the
+     * new session's. It is left to that session, which releases it at its end.
+     */
+    async rejectIfEnded(uri, wasOpen) {
+        if (!this.disposed) {
+            return;
+        }
+        if (!wasOpen && this.modelService.getSession(this.clientId) === undefined) {
+            await this.closeDocument(uri);
+        }
+        throw new SessionClosedError(this.clientId);
+    }
+}
+/**
+ * The framework's {@link ClientSessionFactory}: a {@link DefaultClientSession}
+ * over the {@link ModelService} bound on `model.ModelService`, which the session
+ * serialises and rebuilds through. A model service constructed outside that
+ * slot therefore starts sessions that write through the bound one.
+ *
+ * A subclass that overrides {@link create} to build a session class of its
+ * own passes {@link options} on to that session's constructor; a session built
+ * without them has no slow-update warn and logs under the default name.
+ */
+export class DefaultClientSessionFactory {
+    services;
+    options;
+    tracer;
+    constructor(services, options = {}) {
+        this.services = services;
+        this.options = options;
+        this.tracer = services.Tracer.for(options.logName ?? 'ClientSessionFactory').trace('instantiated');
+    }
+    create(clientId, label) {
+        return new DefaultClientSession(this.services, { ...this.options, clientId, label });
+    }
+}
+//# sourceMappingURL=client-session.js.map

package/lib/langium/model-service/client-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-session.js","sourceRoot":"","sources":["../../../src/langium/model-service/client-session.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAEJ,aAAa,EACb,cAAc,EACd,MAAM,EAGN,eAAe,EAIf,sBAAsB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAgB,oBAAoB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAA2C,OAAO,EAAc,MAAM,uBAAuB,CAAC;AAErG,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAKzH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAyK/D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,oBAAoB;IAoCR,QAAQ;IA9BpB,QAAQ,GAAG,KAAK,CAAC;IAC3B;;;;OAIG;IACgB,YAAY,GAAG,IAAI,GAAG,EAAyB,CAAC;IACnE;;;;;;;;OAQG;IACgB,gBAAgB,GAAG,IAAI,GAAG,EAAoC,CAAC;IAClF,4FAA4F;IACzE,aAAa,CAAa;IAC1B,cAAc,GAAG,IAAI,OAAO,EAAmB,CAAC;IACnE,wJAAwJ;IACrI,MAAM,CAAS;IAClC,iGAAiG;IAC9E,YAAY,CAA6C;IAC5E,0FAA0F;IACvE,cAAc,CAA2B;IACnD,QAAQ,CAAS;IACjB,KAAK,CAAS;IAEvB,YACsB,QAA8B,EACjD,OAA6B;wBADV,QAAQ;QAG3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;QAC/C,wEAAwE;QACxE,gEAAgE;QAChE,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,YAA0D,CAAC;QAC9F,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1H,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1F,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE;YACtE,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACpD,CAAC;QACJ,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI,CAAC,GAAW,EAAE,OAAsB;QACrC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,WAAW,CAAC,GAAW;QACpB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC;YAC5E,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YACnD,CAAC,CAAC,SAAS,CAAC;IAClB,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,IAAY;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAuC,EAAE,WAA+B;QAC5E,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;IAED,SAAS,CACN,IAA2C,EAC3C,WAA+B;QAE/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CACD,IAAwD,EACxD,WAA+B;QAE/B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,CAAC,IAA8B;QACnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,GAAW;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,IAA6B;QACjC,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,QAAQ,CAAI,GAAW,EAAE,EAAyB;QAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,SAAS,CAAC,cAAsB;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,cAAc,KAAK,IAAI,CAAC,QAAQ,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,KAAuB;QAC5B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,OAAO;QACV,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACzE,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC;IAED,IAAI,YAAY;QACb,OAAO,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;IACpC,CAAC;IAES,UAAU;QACjB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjB,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC;IACJ,CAAC;IAED,wGAAwG;IAC9F,UAAU,CAAC,GAAW;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC1C,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,kBAAkB,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/G,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACO,iBAAiB,CAAC,GAAW,EAAE,WAAwB,EAAE,cAAsB;QACtF,IAAI,cAAc,CAAC,WAAW,CAAC,IAAI,cAAc,KAAK,WAAW,EAAE,CAAC;YACjE,0EAA0E;YAC1E,uEAAuE;YACvE,iBAAiB;YACjB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,wBAAwB,WAAW,YAAY,cAAc,EAAE,CAAC,CAAC;YACrG,MAAM,IAAI,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;QAC7D,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACO,YAAY,CAAC,GAAW;QAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,QAAQ,IAAI,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACO,KAAK,CAAC,cAAc,CAC3B,IAAuC,EACvC,WAA+B;QAE/B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC;QACvH,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxG,MAAM,GAAG,GAAG,KAAK,EAAK,KAAa,EAAE,EAAyB,EAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3H,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC;QAC5D,MAAM,KAAK,GAAG,GAAS,EAAE;YACtB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;YACrB,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1E,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACnD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;YAC1B,CAAC;QACJ,CAAC,CAAC;QACF,KAAK,EAAE,CAAC;QACR,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7F,MAAM,cAAc,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE;YAC5C,KAAK,EAAE,CAAC;YACR,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;QACH,wEAAwE;QACxE,wEAAwE;QACxE,wDAAwD;QACxD,0BAA0B;QAC1B,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC,eAAe,EAAE,EAAE,WAAW,CAAC,CAAC,CAAC;QACrI,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,YAAY,GAAG,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,cAAc,cAAc,YAAY,oCAAoC,CAAC,CAAC;QACjH,CAAC;aAAM,CAAC;YACL,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,cAAc,cAAc,QAAQ,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACZ,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACzD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC;YAC3C,IAAI,OAAO,IAAI,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,gBAAgB,OAAO,QAAQ,SAAS,QAAQ,cAAc,YAAY,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;YAC7H,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACzB,OAAO,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC;IAC3D,CAAC;IAED;;;;;;;;;;OAUG;IACO,KAAK,CAAC,eAAe,CAC5B,IAA2C,EAC3C,WAA+B;QAE/B,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;QAClC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC;QAC5D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,KAAK,GAAG,GAAS,EAAE,CACtB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YAC3B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,WAAW,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpF,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACvD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,CAAC;YACD,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACN,KAAK,EAAE,CAAC;QACR,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;QAC7E,CAAC;QACD,wEAAwE;QACxE,uEAAuE;QACvE,yEAAyE;QACzE,KAAK,EAAE,CAAC;QACR,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACtH,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,eAAe,CAAC,eAAe,EAAE,CAAC;QACxE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QACpG,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjI,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAClC,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAC/F,CAAC;QACL,CAAC;QACD,6EAA6E;QAC7E,wEAAwE;QACxE,qDAAqD;QACrD,MAAM,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC;QAC1D,KAAK,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,GAAG,6BAA6B,QAAQ,EAAE,CAAC,CAAC;YACzF,CAAC;iBAAM,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;gBACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,cAAc,GAAG,0BAA0B,QAAQ,KAAK,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACzH,CAAC;QACJ,CAAC;QACD,MAAM,WAAW,CAAC;IACrB,CAAC;IAED;;;;;;;;;OASG;IACO,KAAK,CAAC,YAAY,CACzB,IAAuC,EACvC,WAA+B;QAE/B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,WAAW,CAAC,CAAC;QACpF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;QAClF,OAAO,EAAE,GAAG,GAAG,EAAE,SAAS,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;IAC7C,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,eAAe,CAAC,IAA8B;QAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;OAMG;IACO,KAAK,CAAC,cAAc,CAAC,IAA6B;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;QAClG,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChF,CAAC;IAES,KAAK,CAAC,aAAa,CAAC,GAAW;QACtC,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,uGAAuG;IAC7F,YAAY,CAAC,GAAW,EAAE,OAAiC;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,OAAO,EAAE,CAAC;YACX,OAAO,OAAO,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;YAC1D,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;gBAC1C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,OAAO,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;OAYG;IACO,KAAK,CAAC,YAAY,CAAC,GAAW,EAAE,OAAiC;QACxE,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAC9B,iDAAiD;QACjD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzF,IAAI,CAAC,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxF,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAES,YAAY,CAAC,GAAW;QAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,iBAAiB,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACtE,CAAC;IAES,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,IAAY;QACrD,2EAA2E;QAC3E,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;QAC9B,IAAI,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAChF,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,6EAA6E,CAAC,CAAC;QACtH,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,0BAA0B,CAAC,CAAC;QACnE,CAAC;QACD,sEAAsE;QACtE,qEAAqE;QACrE,uEAAuE;QACvE,oEAAoE;QACpE,oEAAoE;QACpE,8DAA8D;QAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,OAAgC,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;YACtE,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;gBAClE,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC;YACpC,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,IAAI,CAAC;YACF,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QACjG,CAAC;gBAAS,CAAC;YACR,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC;QACD,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,0BAA0B,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,OAAO,CAAC;IAClB,CAAC;IAES,KAAK,CAAC,WAAW,CAAI,GAAW,EAAE,EAAyB;QAClE,uEAAuE;QACvE,qEAAqE;QACrE,MAAM,WAAW,GACd,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,aAAa,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7H,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC;YACF,OAAO,MAAM,EAAE,EAAE,CAAC;QACrB,CAAC;gBAAS,CAAC;YACR,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClC,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;QACJ,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACO,KAAK,CAAC,aAAa,CAAC,GAAW,EAAE,OAAgB;QACxD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACV,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE,CAAC;YACzE,MAAM,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;CACH;AAsDD;;;;;;;;;GASG;AACH,MAAM,OAAO,2BAA2B;IAIf,QAAQ;IACR,OAAO;IAJV,MAAM,CAAS;IAElC,YACsB,QAA8B,EAC9B,OAAO,GAAgC,EAAE;wBADzC,QAAQ;uBACR,OAAO;QAE1B,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,sBAAsB,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACtG,CAAC;IAED,MAAM,CAAC,QAAgB,EAAE,KAAa;QACnC,OAAO,IAAI,oBAAoB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,CAAC;CACH"}

package/lib/langium/model-service/index.d.ts

@@ -6,5 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
+export * from './model-events.js';
 export * from './model-service.js';
+export * from './client-session.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/langium/model-service/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/langium/model-service/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/langium/model-service/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/lib/langium/model-service/index.js

@@ -6,5 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
+export * from './model-events.js';
 export * from './model-service.js';
+export * from './client-session.js';
 //# sourceMappingURL=index.js.map

package/lib/langium/model-service/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/langium/model-service/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/langium/model-service/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/lib/langium/model-service/model-events.d.ts

@@ -0,0 +1,68 @@
+/********************************************************************************
+ * 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 CanonicalUri } from '@hydranium/protocol';
+import { type AstNode, type DocumentState } from '@hydranium/langium';
+import { type AstDocumentSavedEvent, type AstDocumentUpdatedEvent } from '../../documents/ast-document-manager.js';
+import { type DocumentDirtyChangedEvent } from '../../documents/dirty-state-tracker.js';
+import { type DocumentReleasedEvent } from '../../documents/hydranium-text-documents.js';
+import { type AstDiagnostic } from '../validation/document-validator.js';
+/** Which documents a `ModelService` subscription hears about. */
+export interface ModelEventFilter {
+    /** One document, in any spelling; matched by canonical form. Absent for every document. */
+    readonly uri?: string;
+}
+/** A {@link ModelEventFilter} for an event a build phase fires. */
+export interface ModelPhaseFilter extends ModelEventFilter {
+    /** Defaults to `Validated`. */
+    readonly phase?: DocumentState;
+}
+/**
+ * A document reaching {@link phase} in a build.
+ *
+ * `document` holds for the listener's synchronous run: its root is the one the
+ * build carried to the phase, and at `Validated` its diagnostics are that
+ * build's, copied. A later build can unlink that root in place or replace it,
+ * so a listener that awaits first reads the document again through the phase
+ * reads or `snapshot`.
+ *
+ * Below `Validated` the document carries no diagnostics: any it held would be
+ * an earlier build's.
+ */
+export interface ModelUpdatedEvent<TAst extends AstNode, TDiagnostic extends AstDiagnostic = AstDiagnostic> extends AstDocumentUpdatedEvent<TAst, TDiagnostic> {
+    readonly phase: DocumentState;
+}
+/**
+ * The documents one build carried to {@link phase}. Not fired for a cancelled
+ * build. The build that takes over redoes only the documents the cancelled one
+ * left unfinished, so a document it had already completed is reported by no
+ * event until a later build touches it.
+ */
+export interface ModelsBuiltEvent {
+    readonly uris: readonly CanonicalUri[];
+    readonly phase: DocumentState;
+}
+/**
+ * A document's file was removed. No build reaches a deleted document, so no
+ * {@link ModelUpdatedEvent} reports it.
+ */
+export interface ModelDeletedEvent {
+    readonly uri: CanonicalUri;
+    /**
+     * The session whose `delete` removed the file; the unknown-client id for a
+     * file removed outside any session, as a file watcher reports one.
+     */
+    readonly sourceClientId: string;
+}
+/** A document was saved: the AST manager's event, as `ModelService` hands it out. */
+export type ModelSavedEvent<TAst extends AstNode, TDiagnostic extends AstDiagnostic = AstDiagnostic> = AstDocumentSavedEvent<TAst, TDiagnostic>;
+/** A document's text started or stopped differing from its file: the store's event, as `ModelService` hands it out. */
+export type ModelDirtyChangedEvent = DocumentDirtyChangedEvent;
+/** A document no client has open any more was released: the store's event, as `ModelService` hands it out. */
+export type ModelReleasedEvent = DocumentReleasedEvent;
+//# sourceMappingURL=model-events.d.ts.map

package/lib/langium/model-service/model-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-events.d.ts","sourceRoot":"","sources":["../../../src/langium/model-service/model-events.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACnH,OAAO,EAAE,KAAK,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACzF,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC9B,2FAA2F;IAC3F,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACvD,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CACjC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB,CAAC,IAAI,SAAS,OAAO,EAAE,WAAW,SAAS,aAAa,GAAG,aAAa,CAAE,SAAQ,uBAAuB,CACxI,IAAI,EACJ,WAAW,CACb;IACE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC9B,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAC/B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CAClC;AAED,qFAAqF;AACrF,MAAM,MAAM,eAAe,CAAC,IAAI,SAAS,OAAO,EAAE,WAAW,SAAS,aAAa,GAAG,aAAa,IAAI,qBAAqB,CACzH,IAAI,EACJ,WAAW,CACb,CAAC;AAEF,uHAAuH;AACvH,MAAM,MAAM,sBAAsB,GAAG,yBAAyB,CAAC;AAE/D,8GAA8G;AAC9G,MAAM,MAAM,kBAAkB,GAAG,qBAAqB,CAAC"}

package/lib/langium/model-service/model-events.js

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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 {};
+//# sourceMappingURL=model-events.js.map

package/lib/langium/model-service/model-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-events.js","sourceRoot":"","sources":["../../../src/langium/model-service/model-events.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF"}