@hydranium/core 1.0.0-next.10

package/lib/langium/config/settings.js

@@ -0,0 +1,196 @@
+/********************************************************************************
+ * 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 { Emitter } from 'vscode-languageserver';
+/**
+ * Walk a (possibly nested) key path inside the `configuration` subtree
+ * returned by `getConfiguration(root, configuration)`. Returns `undefined`
+ * for any intermediate non-object or missing key — the caller's coercion +
+ * validation then surfaces that as the default.
+ */
+function readKey(subtree, key) {
+    const segments = typeof key === 'string' ? [key] : key;
+    let current = subtree;
+    for (const segment of segments) {
+        if (current === null || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+/**
+ * Producers that bind a user-configurable editor setting (an LSP
+ * `workspace/configuration` section) to an {@link ObservableValue} — the
+ * snapshot updates on the initial fetch and on every `didChangeConfiguration`
+ * push for the section. `Settings` is reserved for this user-config source;
+ * the {@link ObservableValue} the producers yield is itself source-agnostic.
+ */
+export var Settings;
+(function (Settings) {
+    /**
+     * Bind a {@link ObservableValue} to a Langium configuration section. The
+     * snapshot starts at `default` and updates when (a) the initial
+     * `provider.getConfiguration` resolves and (b) every `didChangeConfiguration`
+     * push affecting the same `root`. `onChange` is dedup'd by snapshot identity
+     * (`Object.is`). Errors thrown by `select` fall back to `default`.
+     */
+    function value(options) {
+        const root = options.root ?? options.services.lsp.configurationRoot;
+        const provider = options.services.workspace.ConfigurationProvider;
+        const emitter = new Emitter();
+        let current = options.default;
+        const apply = (subtree) => {
+            let candidate;
+            try {
+                candidate = options.select(subtree);
+            }
+            catch {
+                candidate = options.default;
+            }
+            const next = candidate === undefined || candidate === null ? options.default : candidate;
+            if (!Object.is(next, current)) {
+                current = next;
+                emitter.fire(next);
+            }
+        };
+        // Initial fetch — `provider.ready` resolves after the client's
+        // `initialized` notification. Failures leave the snapshot at `default`;
+        // it still updates via `onConfigurationSectionUpdate` if pushed later.
+        void provider.ready
+            .then(async () => {
+            const subtree = await provider.getConfiguration(root, options.configuration);
+            apply(subtree);
+        })
+            .catch(() => {
+            // On the CHAIN, not inside the callback: a `ready` rejection is a
+            // failure mode of its own, and a handler that only wraps
+            // `getConfiguration` leaves it as an anonymous unhandled rejection.
+        });
+        provider.onConfigurationSectionUpdate(({ section, configuration }) => {
+            if (section !== root) {
+                return;
+            }
+            const subtree = configuration === null || typeof configuration !== 'object'
+                ? undefined
+                : configuration[options.configuration];
+            apply(subtree);
+        });
+        return {
+            get value() {
+                return current;
+            },
+            onChange: emitter.event
+        };
+    }
+    Settings.value = value;
+    /**
+     * Bind a numeric setting with optional string-coercion + range / integer
+     * validation. Any rejection falls back to `default`.
+     */
+    function number(options) {
+        const coerceString = options.coerceString ?? true;
+        return value({
+            services: options.services,
+            root: options.root,
+            configuration: options.configuration,
+            default: options.default,
+            select: subtree => {
+                const raw = readKey(subtree, options.key);
+                let result;
+                if (typeof raw === 'number') {
+                    result = raw;
+                }
+                else if (typeof raw === 'string' && coerceString) {
+                    result = Number.parseFloat(raw);
+                }
+                else {
+                    return undefined;
+                }
+                if (!Number.isFinite(result)) {
+                    return undefined;
+                }
+                if (options.nonNegative && result < 0) {
+                    return undefined;
+                }
+                if (options.min !== undefined && result < options.min) {
+                    return undefined;
+                }
+                if (options.max !== undefined && result > options.max) {
+                    return undefined;
+                }
+                return options.integer ? Math.round(result) : result;
+            }
+        });
+    }
+    Settings.number = number;
+    /**
+     * Bind a boolean setting with optional string-coercion (`'true'`/`'false'`/
+     * `'1'`/`'0'`, case-insensitive). Any other shape falls back to `default`.
+     */
+    function boolean(options) {
+        const coerceString = options.coerceString ?? true;
+        return value({
+            services: options.services,
+            root: options.root,
+            configuration: options.configuration,
+            default: options.default,
+            select: subtree => {
+                const raw = readKey(subtree, options.key);
+                if (typeof raw === 'boolean') {
+                    return raw;
+                }
+                if (typeof raw === 'string' && coerceString) {
+                    const normalised = raw.trim().toLowerCase();
+                    if (normalised === 'true' || normalised === '1') {
+                        return true;
+                    }
+                    if (normalised === 'false' || normalised === '0') {
+                        return false;
+                    }
+                }
+                return undefined;
+            }
+        });
+    }
+    Settings.boolean = boolean;
+    /**
+     * Bind a string setting with optional non-string coercion + allowed-list
+     * validation. Type-parameterise `T` to a literal-string union to correlate
+     * the snapshot type with the `allowed` set at compile time.
+     */
+    function string(options) {
+        const coerceToString = options.coerceToString ?? false;
+        const allowed = options.allowed;
+        return value({
+            services: options.services,
+            root: options.root,
+            configuration: options.configuration,
+            default: options.default,
+            select: subtree => {
+                const raw = readKey(subtree, options.key);
+                let result;
+                if (typeof raw === 'string') {
+                    result = raw;
+                }
+                else if (coerceToString && raw !== undefined && raw !== null) {
+                    result = String(raw);
+                }
+                else {
+                    return undefined;
+                }
+                if (allowed && !allowed.includes(result)) {
+                    return undefined;
+                }
+                return result;
+            }
+        });
+    }
+    Settings.string = string;
+})(Settings || (Settings = {}));
+//# sourceMappingURL=settings.js.map

package/lib/langium/config/settings.js.map

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

package/lib/langium/diagnostics/hydranium-langium-profiler.d.ts

@@ -0,0 +1,109 @@
+/********************************************************************************
+ * 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 Tracer } from '@hydranium/protocol';
+import { DefaultLangiumProfiler, type ProfilingCategory, type ProfilingRecord, ProfilingTask } from '@hydranium/langium';
+import { type LogNameOptions } from './logger.js';
+import { type ServerSharedServicesMinimal } from '../shared-services.js';
+/** Construction options for {@link HydraniumLangiumProfiler}. */
+export interface LangiumProfilerOptions extends LogNameOptions {
+    /**
+     * Categories profiled while active. Defaults (via the base
+     * {@link DefaultLangiumProfiler}) to Langium's full set when omitted.
+     */
+    readonly activeCategories?: Set<ProfilingCategory>;
+    /**
+     * Priority of the per-build flush pass at the `Validated` phase. The flush is
+     * normally the only pass at `Validated`, so order is immaterial; the option
+     * exists for symmetry with the other framework passes. Default
+     * {@link PROFILER_FLUSH_PASS_PRIORITY}.
+     */
+    readonly flushPriority?: number;
+}
+/** Default priority of the profiler's per-build flush pass (see {@link LangiumProfilerOptions.flushPriority}). */
+export declare const PROFILER_FLUSH_PASS_PRIORITY = 0;
+/**
+ * Framework adapter over Langium's {@link DefaultLangiumProfiler} that is
+ * **trace-gated** and emits a single **aggregated** per-category breakdown
+ * once per build through the framework {@link Tracer}, instead of one
+ * `console.table` dump per document.
+ *
+ *  - **Aggregate, not per-document.** Langium creates one profiling task per
+ *    document (`createTask('validating', languageId)`) and the stock
+ *    {@link DefaultLangiumProfiler.dumpRecord} prints each as it completes —
+ *    dozens of near-identical blocks, all labelled with the language id (the
+ *    task identifier), so the per-document records carry no distinguishing
+ *    information anyway. We instead accumulate records in {@link records} and
+ *    {@link flush} one breakdown per category — self-time and invocation counts
+ *    summed per `$type` across the whole build — on the terminal `Validated`
+ *    build phase (self-registered in the constructor). One report per build, not
+ *    one per file.
+ *  - **Transport safety.** The stock per-record dump uses `console.table`, which
+ *    is NOT in the set `patchConsole` reroutes; under `vscode-languageserver`'s
+ *    `--stdio` transport `process.stdout` *is* the JSON-RPC channel, so the
+ *    native ASCII grid corrupts the protocol stream. {@link createTask} bypasses
+ *    `dumpRecord` entirely (records are stored, never grid-printed); {@link flush}
+ *    emits one {@link Tracer} line per row.
+ *  - **Opt-in / no production cost.** {@link isActive} is gated on the global
+ *    `trace` threshold, so at the default `info` level (and even at `debug`)
+ *    every Langium parse/link/validate guard (`profiler?.isActive(category)`)
+ *    short-circuits to `false` and no task is ever created. The per-`$type`
+ *    self-time is high-volume diagnostic detail, so it sits at the `trace` tier
+ *    deliberately — `debug` keeps the readable one-line-per-phase
+ *    `DocumentBuilder` overview without this spam. The gate is evaluated per
+ *    call, so flipping the level at runtime turns profiling on/off without a
+ *    restart. Langium's own `start`/`stop` category selection still applies *on
+ *    top of* the trace gate.
+ *
+ * Registered eagerly (see `DEFAULT_EAGER_SERVICES`) so its `Validated`-phase
+ * flush pass is registered before the first build. Gives the per-grammar-rule /
+ * per-`$type` parse/link/validate self-time the framework's own
+ * `ServerTracer` / `ProfileSession` passes
+ * cannot produce (those cover the framework's passes *outside* Langium's
+ * parse/link/validate categories).
+ */
+export declare class HydraniumLangiumProfiler extends DefaultLangiumProfiler {
+    /** Component-tagged tracer (`LangiumProfiler`); the per-category tag is added per flush. */
+    protected readonly tracer: Tracer;
+    constructor(services: ServerSharedServicesMinimal, options?: LangiumProfilerOptions);
+    /**
+     * A category profiles only while the global threshold admits `trace` *and*
+     * Langium's category selection has it active. The trace gate is the master
+     * switch (zero cost at `info`/`debug`); the category set is the sub-selection.
+     */
+    isActive(category: ProfilingCategory): boolean;
+    /**
+     * Accumulate each completed task's record in {@link records} for the
+     * end-of-build {@link flush}. Bypasses the base's `console.table`
+     * {@link DefaultLangiumProfiler.dumpRecord} (the `--stdio` hazard) — records
+     * are stored, never grid-printed.
+     */
+    createTask(category: ProfilingCategory, taskId: string): ProfilingTask;
+    /**
+     * Snapshot a completed record's `entries` into an independent {@link MultiMap}.
+     * {@link ProfilingTask.stop} clears its `entries` immediately after invoking
+     * this callback, and the record holds that map by reference — so the read
+     * MUST happen now (the stock `dumpRecord` reads synchronously here too).
+     * Deferring to {@link flush} without this copy would see emptied entries.
+     */
+    protected captureRecord(record: ProfilingRecord): ProfilingRecord;
+    /**
+     * Emit one aggregated breakdown per category — self-time and invocation
+     * counts summed per `<languageId>.<$type>` across every record collected
+     * this build — then clear the window. Self-registered as a `Validated`-phase
+     * build pass, so it fires once per build, not per document. Pass explicit
+     * categories to flush a subset; defaults to all.
+     *
+     * `flush` is the sole reset point: because it clears each flushed category,
+     * memory is bounded per completed build. A build cancelled before `Validated`
+     * leaves its partial records to roll into the next build's flush (slightly
+     * inflated counts, self-correcting) rather than accumulating without bound.
+     */
+    flush(...categories: ProfilingCategory[]): void;
+}
+//# sourceMappingURL=hydranium-langium-profiler.d.ts.map

package/lib/langium/diagnostics/hydranium-langium-profiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydranium-langium-profiler.d.ts","sourceRoot":"","sources":["../../../src/langium/diagnostics/hydranium-langium-profiler.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EACJ,sBAAsB,EAGtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,aAAa,EACf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,uBAAuB,CAAC;AAKzE,iEAAiE;AACjE,MAAM,WAAW,sBAAuB,SAAQ,cAAc;IAC3D;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,kHAAkH;AAClH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,wBAAyB,SAAQ,sBAAsB;IACjE,4FAA4F;IAC5F,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEtB,QAAQ,EAAE,2BAA2B,EAAE,OAAO,GAAE,sBAA2B;IAevF;;;;OAIG;IACM,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO;IAIvD;;;;;OAKG;IACM,UAAU,CAAC,QAAQ,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAO/E;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe;IAUjE;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,UAAU,EAAE,iBAAiB,EAAE,GAAG,IAAI;CAiCjD"}

package/lib/langium/diagnostics/hydranium-langium-profiler.js

@@ -0,0 +1,153 @@
+/********************************************************************************
+ * 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 { Format, Logger } from '@hydranium/protocol';
+import { DefaultLangiumProfiler, DocumentState, MultiMap, ProfilingTask } from '@hydranium/langium';
+/** Langium's full profiling-category set — the default window {@link HydraniumLangiumProfiler.flush} aggregates. */
+const ALL_CATEGORIES = ['parsing', 'linking', 'validating'];
+/** Default priority of the profiler's per-build flush pass (see {@link LangiumProfilerOptions.flushPriority}). */
+export const PROFILER_FLUSH_PASS_PRIORITY = 0;
+/**
+ * Framework adapter over Langium's {@link DefaultLangiumProfiler} that is
+ * **trace-gated** and emits a single **aggregated** per-category breakdown
+ * once per build through the framework {@link Tracer}, instead of one
+ * `console.table` dump per document.
+ *
+ *  - **Aggregate, not per-document.** Langium creates one profiling task per
+ *    document (`createTask('validating', languageId)`) and the stock
+ *    {@link DefaultLangiumProfiler.dumpRecord} prints each as it completes —
+ *    dozens of near-identical blocks, all labelled with the language id (the
+ *    task identifier), so the per-document records carry no distinguishing
+ *    information anyway. We instead accumulate records in {@link records} and
+ *    {@link flush} one breakdown per category — self-time and invocation counts
+ *    summed per `$type` across the whole build — on the terminal `Validated`
+ *    build phase (self-registered in the constructor). One report per build, not
+ *    one per file.
+ *  - **Transport safety.** The stock per-record dump uses `console.table`, which
+ *    is NOT in the set `patchConsole` reroutes; under `vscode-languageserver`'s
+ *    `--stdio` transport `process.stdout` *is* the JSON-RPC channel, so the
+ *    native ASCII grid corrupts the protocol stream. {@link createTask} bypasses
+ *    `dumpRecord` entirely (records are stored, never grid-printed); {@link flush}
+ *    emits one {@link Tracer} line per row.
+ *  - **Opt-in / no production cost.** {@link isActive} is gated on the global
+ *    `trace` threshold, so at the default `info` level (and even at `debug`)
+ *    every Langium parse/link/validate guard (`profiler?.isActive(category)`)
+ *    short-circuits to `false` and no task is ever created. The per-`$type`
+ *    self-time is high-volume diagnostic detail, so it sits at the `trace` tier
+ *    deliberately — `debug` keeps the readable one-line-per-phase
+ *    `DocumentBuilder` overview without this spam. The gate is evaluated per
+ *    call, so flipping the level at runtime turns profiling on/off without a
+ *    restart. Langium's own `start`/`stop` category selection still applies *on
+ *    top of* the trace gate.
+ *
+ * Registered eagerly (see `DEFAULT_EAGER_SERVICES`) so its `Validated`-phase
+ * flush pass is registered before the first build. Gives the per-grammar-rule /
+ * per-`$type` parse/link/validate self-time the framework's own
+ * `ServerTracer` / `ProfileSession` passes
+ * cannot produce (those cover the framework's passes *outside* Langium's
+ * parse/link/validate categories).
+ */
+export class HydraniumLangiumProfiler extends DefaultLangiumProfiler {
+    /** Component-tagged tracer (`LangiumProfiler`); the per-category tag is added per flush. */
+    tracer;
+    constructor(services, options = {}) {
+        super(options.activeCategories);
+        this.tracer = services.Tracer.for(options.logName ?? 'LangiumProfiler').trace('instantiated');
+        // Flush once per build on the terminal phase rather than once per document.
+        // By `Validated`, every parse/link/validate record for the batch is in.
+        // Registered as a build-phase pass (not a direct onBuildPhase listener) so
+        // every framework + adopter build-phase reaction shares one dispatcher.
+        services.workspace.BuildPhasePassService.register({
+            id: 'framework:langium-profiler:flush',
+            state: DocumentState.Validated,
+            priority: options.flushPriority ?? PROFILER_FLUSH_PASS_PRIORITY,
+            run: () => this.flush()
+        });
+    }
+    /**
+     * A category profiles only while the global threshold admits `trace` *and*
+     * Langium's category selection has it active. The trace gate is the master
+     * switch (zero cost at `info`/`debug`); the category set is the sub-selection.
+     */
+    isActive(category) {
+        return Logger.isLevelEnabled('trace') && super.isActive(category);
+    }
+    /**
+     * Accumulate each completed task's record in {@link records} for the
+     * end-of-build {@link flush}. Bypasses the base's `console.table`
+     * {@link DefaultLangiumProfiler.dumpRecord} (the `--stdio` hazard) — records
+     * are stored, never grid-printed.
+     */
+    createTask(category, taskId) {
+        if (!this.isActive(category)) {
+            throw new Error(`Category "${category}" is not active.`);
+        }
+        return new ProfilingTask(record => this.records.add(category, this.captureRecord(record)), taskId);
+    }
+    /**
+     * Snapshot a completed record's `entries` into an independent {@link MultiMap}.
+     * {@link ProfilingTask.stop} clears its `entries` immediately after invoking
+     * this callback, and the record holds that map by reference — so the read
+     * MUST happen now (the stock `dumpRecord` reads synchronously here too).
+     * Deferring to {@link flush} without this copy would see emptied entries.
+     */
+    captureRecord(record) {
+        const entries = new MultiMap();
+        for (const key of record.entries.keys()) {
+            for (const value of record.entries.get(key)) {
+                entries.add(key, value);
+            }
+        }
+        return { ...record, entries };
+    }
+    /**
+     * Emit one aggregated breakdown per category — self-time and invocation
+     * counts summed per `<languageId>.<$type>` across every record collected
+     * this build — then clear the window. Self-registered as a `Validated`-phase
+     * build pass, so it fires once per build, not per document. Pass explicit
+     * categories to flush a subset; defaults to all.
+     *
+     * `flush` is the sole reset point: because it clears each flushed category,
+     * memory is bounded per completed build. A build cancelled before `Validated`
+     * leaves its partial records to roll into the next build's flush (slightly
+     * inflated counts, self-correcting) rather than accumulating without bound.
+     */
+    flush(...categories) {
+        const toFlush = categories.length > 0 ? categories : ALL_CATEGORIES;
+        for (const category of toFlush) {
+            const records = this.getRecords(category).toArray();
+            if (records.length === 0) {
+                continue;
+            }
+            const totals = new Map();
+            let totalMs = 0;
+            for (const record of records) {
+                totalMs += record.duration;
+                for (const key of record.entries.keys()) {
+                    const name = `${record.identifier}.${key}`;
+                    const values = record.entries.get(key);
+                    const aggregate = totals.get(name) ?? { count: 0, selfMs: 0 };
+                    aggregate.count += values.length;
+                    aggregate.selfMs += values.reduce((sum, value) => sum + value, 0);
+                    totals.set(name, aggregate);
+                }
+            }
+            const rows = [...totals.entries()]
+                .map(([name, aggregate]) => ({ name, ...aggregate }))
+                .sort((left, right) => right.selfMs - left.selfMs);
+            const log = this.tracer.sub(category);
+            log.trace(`${category}: ${records.length} docs, ${Format.elapsed(totalMs)} total`);
+            for (const row of rows) {
+                const pct = totalMs > 0 ? Math.round((100 * row.selfMs) / totalMs) : 0;
+                log.trace(`${row.name} ×${row.count} ${pct}% ${Format.elapsed(row.selfMs)}`);
+            }
+            this.records.delete(category);
+        }
+    }
+}
+//# sourceMappingURL=hydranium-langium-profiler.js.map

package/lib/langium/diagnostics/hydranium-langium-profiler.js.map

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

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

@@ -0,0 +1,14 @@
+/********************************************************************************
+ * 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 './hydranium-langium-profiler.js';
+export * from './log-preamble.js';
+export * from './logger.js';
+export * from './lsp-logger.js';
+export * from './server-tracer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/langium/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAOlF,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/lib/langium/diagnostics/index.js

@@ -0,0 +1,19 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+// Node-only diagnostics (`event-loop-monitor`, `memory-monitor`,
+// `server-state-snapshot`) live in `@hydranium/core/node` — they pull
+// `node:perf_hooks` / `node:v8`. `logger`/`lsp-logger`/`log-preamble` stay
+// portable here (the file-tee + Node runtime details are injected, so the
+// barrel stays browser-executable).
+export * from './hydranium-langium-profiler.js';
+export * from './log-preamble.js';
+export * from './logger.js';
+export * from './lsp-logger.js';
+export * from './server-tracer.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/langium/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,iEAAiE;AACjE,sEAAsE;AACtE,2EAA2E;AAC3E,0EAA0E;AAC1E,oCAAoC;AACpC,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/lib/langium/diagnostics/log-file-token.d.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Derive the `{workspace}` placeholder token from a workspace folder URI or
+ * filesystem path: its basename, with filename-unsafe characters replaced by
+ * `_`. The server (file-tee) and a log-correlating test harness call this on
+ * the same workspace path so they agree on the file name.
+ */
+export declare function toLogFileWorkspaceToken(uriOrPath: string): string;
+//# sourceMappingURL=log-file-token.d.ts.map

package/lib/langium/diagnostics/log-file-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-file-token.d.ts","sourceRoot":"","sources":["../../../src/langium/diagnostics/log-file-token.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAOlF;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAKjE"}

package/lib/langium/diagnostics/log-file-token.js

@@ -0,0 +1,25 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+// Dependency-light on purpose: no Langium / vscode-* imports, so a Playwright
+// test helper (which correlates server logs to a workspace) can reuse the exact
+// same token derivation without pulling the language-server module graph. The
+// env-var-name conventions it pairs with live in `@hydranium/protocol`.
+/**
+ * Derive the `{workspace}` placeholder token from a workspace folder URI or
+ * filesystem path: its basename, with filename-unsafe characters replaced by
+ * `_`. The server (file-tee) and a log-correlating test harness call this on
+ * the same workspace path so they agree on the file name.
+ */
+export function toLogFileWorkspaceToken(uriOrPath) {
+    const trimmed = uriOrPath.replace(/[/\\]+$/, '');
+    const lastSep = Math.max(trimmed.lastIndexOf('/'), trimmed.lastIndexOf('\\'));
+    const base = trimmed.slice(lastSep + 1);
+    return base.replace(/[^A-Za-z0-9._-]/g, '_') || 'workspace';
+}
+//# sourceMappingURL=log-file-token.js.map

package/lib/langium/diagnostics/log-file-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-file-token.js","sourceRoot":"","sources":["../../../src/langium/diagnostics/log-file-token.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,8EAA8E;AAC9E,gFAAgF;AAChF,8EAA8E;AAC9E,wEAAwE;AAExE;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACtD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,IAAI,WAAW,CAAC;AAC/D,CAAC"}

package/lib/langium/diagnostics/log-preamble.d.ts

@@ -0,0 +1,42 @@
+/********************************************************************************
+ * Copyright (c) 2023-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 Logger } from '@hydranium/protocol';
+export interface LogPreambleOptions {
+    /** Product name shown in the session header. */
+    productName: string;
+    /** Resolved product version. */
+    version: string;
+    /**
+     * Threshold (ms) above which the framework emits per-phase rebuild detail in
+     * its document builder. Used in the format-conventions section so log readers
+     * know which timings expand into sub-phases. Defaults to 50.
+     */
+    phaseDetailThresholdMs?: number;
+    /**
+     * Extra session-info lines appended to the header block (e.g. Node
+     * runtime / platform / pid / heap-limit / host). Empty on portable hosts;
+     * `@hydranium/core/node`'s `nodeSystemInfoLines()` supplies them on Node.
+     */
+    systemInfoLines?: readonly string[];
+    /**
+     * Extra format-convention lines appended to the conventions block (e.g. the
+     * Node-only `[EventLoop]` / `[Memory]` monitor + memory-suffix behaviour).
+     * Empty on portable hosts; `@hydranium/core/node`'s `nodeConventionLines()`
+     * supplies them on Node.
+     */
+    conventionLines?: readonly string[];
+}
+/**
+ * Emits session info and log format conventions. The body is portable
+ * (browser-safe); Node-specific runtime details and monitor conventions are
+ * injected via {@link LogPreambleOptions.systemInfoLines} /
+ * {@link LogPreambleOptions.conventionLines} (see `@hydranium/core/node`).
+ */
+export declare function logPreamble(logger: Logger, options: LogPreambleOptions): void;
+//# sourceMappingURL=log-preamble.d.ts.map

package/lib/langium/diagnostics/log-preamble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-preamble.d.ts","sourceRoot":"","sources":["../../../src/langium/diagnostics/log-preamble.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlE,MAAM,WAAW,kBAAkB;IAChC,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAG7E"}