likec4 1.57.0 → 1.58.0

package/dist/chunks/index2.d.mts

@@ -1,6 +1,5 @@
 import { i as __name } from "./rolldown-runtime.mjs";
 import { a as LikeC4ProjectConfig, i as IncludeConfig, o as LikeC4ProjectConfigInput } from "./index.mjs";
-import { t as Logger } from "./libs/@logtape/logtape.mjs";
 import { $ as FileSystemProvider, A as DefaultValueConverter, B as AsyncDisposable, C as CodeLensParams, D as ValidationOptions, E as DefaultDocumentValidator, F as JSDocDocumentationProvider, G as Reference, H as AstNode, I as DefaultIndexManager, J as LangiumDocument, K as ReferenceInfo, L as ReferenceDescription, M as MaybePromise, N as DefaultScopeProvider, O as DiagnosticInfo, P as Scope, Q as FileSystemNode, R as DefaultNameProvider, S as CodeActionParams, T as DocumentSymbolParams, U as AstNodeDescription, V as Disposable$1, W as CstNode, X as PrecomputedScopes, Y as LangiumDocumentFactory, Z as Stream, _ as CodeLensProvider, _t as SymbolKind, a as LangiumServices, at as CodeAction, b as FileSelector, c as AbstractSemanticTokenProvider, ct as CompletionItemKind, d as AbstractFormatter, dt as DocumentLink, et as Keyword, f as FormattingRegion, ft as DocumentSymbol, g as DefaultDocumentHighlightProvider, gt as Range, h as DocumentLinkProvider, ht as Location, i as NextFeature, it as RequestType, j as ValueType, k as DefaultScopeComputation, l as SemanticTokenAcceptor, lt as Diagnostic, m as NodeKindProvider, mt as Hover, n as CompletionContext, nt as CancellationToken$1, o as LangiumSharedServices, ot as CodeLens, p as DocumentSymbolProvider, pt as FormattingOptions, q as DefaultLangiumDocuments, r as DefaultCompletionProvider, rt as NotificationType, s as DefaultWorkspaceSymbolProvider, st as Command, t as CompletionAcceptor, tt as URI, u as AstNodeHoverProvider, ut as DocumentHighlight, v as CodeActionProvider, vt as TextEdit, w as DocumentLinkParams, x as BuildOptions, y as DefaultWorkspaceManager, yt as WorkspaceFolder, z as WorkspaceCache } from "./libs/langium.mjs";
 import { t as $keywords } from "./libs/@ts-graphviz/common.mjs";
 import { LikeC4Styles } from "@likec4/core/styles";
@@ -13,739 +12,1582 @@ import { AdhocViewPredicate, ComputedProjectsView, LayoutedProjectsView } from "
 import * as type_fest0 from "type-fest";
 import { ConditionalPick, MergeExclusive, Simplify, Tagged, ValueOf, Writable } from "type-fest";
 
-//#region ../layouts/dist/_chunks/types.d.mts
+//#region ../../node_modules/.pnpm/@logtape+logtape@2.1.1/node_modules/@logtape/logtape/dist/level.d.ts
+//#region src/level.d.ts
+declare const logLevels: readonly ["trace", "debug", "info", "warning", "error", "fatal"];
 /**
- * invisible edge added by AI to enforce better layout
+ * The severity level of a {@link LogRecord}.
  */
-interface AIEnforcementEdge {
-  source: NodeId;
-  target: NodeId;
-  weight?: number;
-  minlen?: number;
-}
+type LogLevel = typeof logLevels[number];
 /**
- * Complete set of AI-generated layout hints.
- * This is the JSON schema the LLM must produce.
+ * Lists all available log levels with the order of their severity.
+ * The `"trace"` level goes first, and the `"fatal"` level goes last.
+ * @returns A new copy of the array of log levels.
+ * @since 1.0.0
  */
-interface AILayoutHints {
-  direction?: 'TB' | 'BT' | 'LR' | 'RL';
-  ranks: ReadonlyArray<{
-    rank: 'same' | 'source' | 'sink' | 'min' | 'max';
-    nodes: NonEmptyArray<NodeId>;
-  }>;
-  edgeWeight: Record<EdgeId, number>;
-  edgeMinlen: Record<EdgeId, number>;
+//#endregion
+//#region ../../node_modules/.pnpm/@logtape+logtape@2.1.1/node_modules/@logtape/logtape/dist/record.d.ts
+//#region src/record.d.ts
+/**
+ * A log record.
+ */
+interface LogRecord {
   /**
-   * These edges should be reversed in DOT
-   * Unique array of EdgeIds.
+   * The category of the logger that produced the log record.
    */
-  reverseRank?: NonEmptyReadonlyArray<EdgeId>;
+  readonly category: readonly string[];
   /**
-   * These edges should be excluded, i.e. `constraint=false` in Graphviz, to allow more flexible layouts.
-   * Unique array of EdgeIds.
+   * The log level.
    */
-  excludeFromRanking?: NonEmptyReadonlyArray<EdgeId>;
+  readonly level: LogLevel;
   /**
-   * Suggested order of edges for DOT output, to influence edge routing.
+   * The log message.  This is the result of substituting the message template
+   * with the values.  The number of elements in this array is always odd,
+   * with the message template values interleaved between the substitution
+   * values.
    */
-  edgeOrder?: NonEmptyReadonlyArray<EdgeId>;
+  readonly message: readonly unknown[];
   /**
-   * Suggested order of nodes for DOT output, to influence node placement.
+   * The raw log message.  This is the original message template without any
+   * further processing.  It can be either:
+   *
+   * - A string without any substitutions if the log record was created with
+   *   a method call syntax, e.g., "Hello, {name}!" for
+   *   `logger.info("Hello, {name}!", { name })`.
+   * - A template string array if the log record was created with a tagged
+   *   template literal syntax, e.g., `["Hello, ", "!"]` for
+   *   ``logger.info`Hello, ${name}!```.
+   *
+   * @since 0.6.0
    */
-  nodeOrder?: NonEmptyReadonlyArray<NodeId>;
+  readonly rawMessage: string | TemplateStringsArray;
   /**
-   * Invisible edges added by AI to enforce better layout
+   * The timestamp of the log record in milliseconds since the Unix epoch.
    */
-  invisibleEdges?: NonEmptyReadonlyArray<AIEnforcementEdge>;
+  readonly timestamp: number;
   /**
-   * LLM reasoning for debugging/display
+   * The extra properties of the log record.
    */
-  reasoning: string;
-} //#endregion
+  readonly properties: Record<string, unknown>;
+} //# sourceMappingURL=record.d.ts.map
 //#endregion
-//#region ../language-server/dist/_chunks/protocol.d.mts
-/**
- * When server requests to open a likec4 preview panel
- * (available only in the editor).
- * (not the best place, but seems to be working)
- */
-declare namespace DidRequestOpenViewNotification {
-  type Params = {
-    viewId: ViewId$1;
-    projectId: ProjectId$1;
-  };
-  const type: NotificationType<Params>;
-  type Type = typeof type;
-}
-/**
- * Request to fetch the computed model data
- * If LSP has multiple projects, the projectId is required.
- * otherwise throws an error.
- */
+//#endregion
+//#region ../../node_modules/.pnpm/@logtape+logtape@2.1.1/node_modules/@logtape/logtape/dist/logger.d.ts
 /**
- * Request to locate an element, relation, deployment or view.
- * If LSP has multiple projects, the projectId is required.
+ * A logger interface.  It provides methods to log messages at different
+ * severity levels.
+ *
+ * ```typescript
+ * const logger = getLogger("category");
+ * logger.trace `A trace message with ${value}`
+ * logger.debug `A debug message with ${value}.`;
+ * logger.info `An info message with ${value}.`;
+ * logger.warn `A warning message with ${value}.`;
+ * logger.error `An error message with ${value}.`;
+ * logger.fatal `A fatal error message with ${value}.`;
+ * ```
+ *
+ * Callback-based string-message overloads should be treated as
+ * fire-and-forget.  Async callbacks return `Promise<void>`, and when a
+ * callback is filtered out because the level is disabled an implementation may
+ * still return an already-resolved promise so the async path remains awaitable
+ * without invoking the callback.  Call sites should not branch on these
+ * return values.
  */
-declare namespace Locate {
-  type Params =
+interface Logger {
   /**
-   * Locate an element by its fqn
+   * The category of the logger.  It is an array of strings.
    */
-  {
-    element: Fqn$1;
-    projectId?: string | undefined;
-    property?: string;
-  }
+  readonly category: readonly string[];
   /**
-   * Locate a relation by its id
+   * The logger with the supercategory of the current logger.  If the current
+   * logger is the root logger, this is `null`.
    */
-  | {
-    projectId?: string | undefined;
-    relation: RelationId;
-  }
+  readonly parent: Logger | null;
   /**
-   * Locate a deployment by its fqn
+   * Get a child logger with the given subcategory.
+   *
+   * ```typescript
+   * const logger = getLogger("category");
+   * const subLogger = logger.getChild("sub-category");
+   * ```
+   *
+   * The above code is equivalent to:
+   *
+   * ```typescript
+   * const logger = getLogger("category");
+   * const subLogger = getLogger(["category", "sub-category"]);
+   * ```
+   *
+   * @param subcategory The subcategory.
+   * @returns The child logger.
    */
-  | {
-    deployment: DeploymentFqn;
-    projectId?: string | undefined;
-    property?: string;
-  }
+  getChild(subcategory: string | readonly [string] | readonly [string, ...string[]]): Logger;
   /**
-   * Locate a step in a dynamic view by its astPath
+   * Get a logger with contextual properties.  This is useful for
+   * log multiple messages with the shared set of properties.
+   *
+   * ```typescript
+   * const logger = getLogger("category");
+   * const ctx = logger.with({ foo: 123, bar: "abc" });
+   * ctx.info("A message with {foo} and {bar}.");
+   * ctx.warn("Another message with {foo}, {bar}, and {baz}.", { baz: true });
+   * ```
+   *
+   * The above code is equivalent to:
+   *
+   * ```typescript
+   * const logger = getLogger("category");
+   * logger.info("A message with {foo} and {bar}.", { foo: 123, bar: "abc" });
+   * logger.warn(
+   *   "Another message with {foo}, {bar}, and {baz}.",
+   *   { foo: 123, bar: "abc", baz: true },
+   * );
+   * ```
+   *
+   * @param properties
+   * @returns
+   * @since 0.5.0
    */
-  | {
-    view: ViewId$1;
-    astPath: string;
-    projectId?: string | undefined;
-  }
+  with(properties: Record<string, unknown>): Logger;
   /**
-   * Locate a view by its id
+   * Log a trace message.  Use this as a template string prefix.
+   *
+   * ```typescript
+   * logger.trace `A trace message with ${value}.`;
+   * ```
+   *
+   * @param message The message template strings array.
+   * @param values The message template values.
+   * @since 0.12.0
    */
-  | {
-    view: ViewId$1;
-    projectId?: string | undefined;
-  };
-  type Res = Location | null;
-  const req: RequestType<Params, Res, void>;
-  type Req = typeof req;
-}
-/**
- * Request to change the view
- * If LSP has multiple projects, the projectId is required.
- */
-declare namespace ChangeView {
-  type Params = {
-    viewId: ViewId$1;
-    change: ViewChange;
-    projectId?: string | undefined;
-  };
-  type Res = {
-    success: true;
-    location: Location | null;
-  } | {
-    success: false;
-    location?: Location | null;
-    error: string;
-  };
-  const req: RequestType<Params, Res, void>;
-  type Req = typeof req;
-}
-/**
- * Request to fetch telemetry metrics
- */
-//#endregion
-//#region ../layouts/dist/_chunks/GraphvizLayoter.d.mts
-//#region src/graphviz/types.d.ts
-/**
- * Partially implements CancellationToken interface from vscode-jsonrpc
- */
-type CancellationToken = {
+  trace(message: TemplateStringsArray, ...values: readonly unknown[]): void;
   /**
-   * Is `true` when the token has been cancelled, `false` otherwise.
+   * Log a trace message with properties.
+   *
+   * ```typescript
+   * logger.trace('A trace message with {value}.', { value });
+   * ```
+   *
+   * If the properties are expensive to compute, you can pass a callback that
+   * returns the properties:
+   *
+   * ```typescript
+   * logger.trace(
+   *   'A trace message with {value}.',
+   *   () => ({ value: expensiveComputation() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties The values to replace placeholders with.  For lazy
+   *                   evaluation, this can be a callback that returns the
+   *                   properties.
+   * @since 0.12.0
    */
-  readonly isCancellationRequested: boolean;
-};
-declare module 'ts-graphviz' {
-  namespace GraphAttributeKey {
-    interface $values extends $keywords<'likec4_viewId'> {}
-  }
-  namespace ClusterSubgraphAttributeKey {
-    interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {}
-  }
-  namespace NodeAttributeKey {
-    interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_project' | 'likec4_level'> {}
-  }
-  namespace EdgeAttributeKey {
-    interface $values extends $keywords<'likec4_id' | 'likec4_project'> {}
-  }
-  namespace Attribute {
-    interface $keys extends $keywords<'likec4_viewId' | 'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_project' | 'likec4_level' | 'likec4_depth'> {}
-    interface $types {
-      likec4_viewId: string;
-      likec4_type: 'folder' | 'file' | 'view';
-      likec4_path: string;
-      likec4_id: string;
-      likec4_project: string;
-      likec4_level: number;
-      likec4_depth: number;
-    }
-  }
-}
-type DotSource = Tagged<string, 'DotSource'>; //#endregion
-//#region src/graphviz/types-dot.d.ts
-type GvNodeName = Tagged<string, 'GvNodeName'>;
-type GvId = Tagged<number, 'GvId'>;
-type Point = [x: number, y: number];
-interface GraphvizJson {
-  name: GvNodeName;
-  directed: boolean;
-  strict: boolean;
-  _draw_: GraphvizJson.Draw[];
-  bb: string;
-  compound: string;
-  fontname: string;
-  fontsize: string;
-  label: string;
-  nodesep: string;
-  outputorder: string;
-  rankdir: string;
-  ranksep: string;
-  splines: string;
-  xdotversion: string;
-  _subgraph_cnt: number;
-  objects?: GraphvizJson.GvObject[];
-  edges?: GraphvizJson.Edge[];
-}
-declare namespace GraphvizJson {
-  interface Draw {
-    op: string;
-    grad: string;
-    color: string;
-    points: Point[];
-  }
-  interface Draw2 {
-    op: string;
-    grad: string;
-    color: string;
-    points: Point[];
-  }
-  namespace DrawOps {
-    type Style = {
-      op: 'S';
-      style: string;
-    };
-    type BSpline = {
-      op: 'b' | 'B';
-      points: Point[];
-    };
-    type Color = {
-      op: 'c';
-      grad: string;
-      color: string;
-    };
-    type Polygon = {
-      op: 'p' | 'P';
-      points: Point[];
-    };
-  }
-  type DrawOp = DrawOps.Style | DrawOps.BSpline | DrawOps.Color | DrawOps.Polygon;
-  type LabelDrawOps = {
-    op: 'F';
-    size: number;
-    face: string;
-  } | {
-    op: 'c';
-    color: string;
-  } | {
-    op: 't';
-    fontchar: number;
-  } | {
-    op: 'T';
-    pt: Point;
-    align: 'l' | 'r' | 'c';
-    width: number;
-    text: string;
-  };
-  type GvObject = GvNodeObject | GvSubgraph;
-  interface GvSubgraph {
-    bb: string;
-    label?: string;
-    compound: 'true';
-    _ldraw_?: LabelDrawOps[];
-    likec4_type?: 'folder' | 'file';
-    likec4_path?: string;
-    likec4_id?: Fqn$1;
-    likec4_level?: number;
-    likec4_depth?: number;
-    _gvid: GvId;
-    subgraphs?: GvId[];
-    nodes?: GvId[];
-    edges?: GvId[];
-  }
-  interface GvNodeObject {
-    _draw_: Draw[];
-    _ldraw_?: LabelDrawOps[];
-    likec4_type?: 'folder' | 'file' | 'view';
-    likec4_path?: string;
-    likec4_id?: Fqn$1;
-    likec4_level?: number;
-    _gvid: GvId;
-    height: string;
-    pos: string;
-    shape: 'rect';
-    width: string;
-    label?: string;
-  }
-  interface Draw3 {
-    op: string;
-    grad: string;
-    color: string;
-    points: Point[];
-  }
-  interface Hdraw {
-    op: string;
-    style: string;
-    grad: string;
-    color: string;
-    points: Point[];
-  }
-  interface Edge {
-    _gvid: GvId;
-    tail: GvId;
-    head: GvId;
-    dir?: 'forward' | 'back' | 'both' | 'none';
-    _draw_: DrawOp[];
-    _hdraw_?: DrawOp[];
-    _tdraw_?: DrawOp[];
-    _ldraw_?: LabelDrawOps[];
-    _tldraw_?: LabelDrawOps[];
-    _hldraw_?: LabelDrawOps[];
-    fontname: string;
-    fontsize: string;
-    likec4_id?: EdgeId$1;
-    label: string;
-    lp: string;
-    nojustify?: 'true' | 'false';
-    pos?: string;
-  }
-} //#endregion
-//#region src/graphviz/GraphvizLayoter.d.ts
-interface GraphvizPort extends Disposable {
-  get name(): string;
-  get concurrency(): number;
-  unflatten(dot: DotSource): Promise<DotSource>;
-  acyclic(dot: DotSource): Promise<DotSource>;
-  layoutJson(dot: DotSource): Promise<string>;
-  svg(dot: DotSource): Promise<string>;
-  dispose(): void;
-}
-type LayoutTaskParams<A extends aux$1.Any = aux$1.Any> = {
-  view: ComputedView<A>;
-  styles: LikeC4Styles$1;
-};
-type LayoutResult<A extends aux$1.Any = aux$1.Any> = {
-  dot: DotSource;
-  diagram: DiagramView<A>;
-};
-declare class GraphvizLayouter implements Disposable {
-  private graphviz;
-  constructor(graphviz?: GraphvizPort);
-  dispose(): void;
-  [Symbol.dispose](): void;
-  get graphvizPort(): GraphvizPort;
-  changePort(graphviz: GraphvizPort): void;
+  trace(message: string, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
   /**
-   * Generates DOT source for the given view and styles.
-   * If `hints` are provided, they will be used to influence the layout (e.g. by specifying node/edge order).
-   * This method does not perform unflattening or any other post-processing on the DOT output, so it may be used for debugging or to generate DOT for external processing.
+   * Log a trace message with properties computed asynchronously.
+   *
+   * Use this when the properties require async operations to compute:
+   *
+   * ```typescript
+   * await logger.trace(
+   *   'A trace message with {value}.',
+   *   async () => ({ value: await fetchValue() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.0.0
    */
-  printToDot(params: LayoutTaskParams, hints?: AILayoutHints): DotSource;
-  protected newScopedLogger(operation: string): any;
-  dotToJson(dot: DotSource): Promise<GraphvizJson>;
-  layout<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<LayoutResult<A>>;
-  aiLayout<A extends AnyAux>({
-    view,
-    styles
-  }: LayoutTaskParams<A>, hints: AILayoutHints): Promise<LayoutResult<A>>;
-  svg<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<{
-    svg: string;
-    dot: DotSource;
-  }>;
-  dot<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<DotSource>;
-  layoutProjectsView(view: ComputedProjectsView): Promise<LayoutedProjectsView>;
-} //#endregion
-//#endregion
-//#region ../layouts/dist/index.d.mts
-//#region src/graphviz/QueueGraphvizLayoter.d.ts
-declare class QueueGraphvizLayoter extends GraphvizLayouter {
-  private queue;
-  private isProcessingBatch;
-  constructor(options?: {
-    graphviz?: GraphvizPort;
-    /**
-     * Concurrency limit.
-     * Minimum: `1`.
-     * @default 2
-     */
-    concurrency?: number;
-    /**
-     * Per-operation timeout in milliseconds. Operations fulfill once `timeout` elapses if they haven't already.
-     * @default 20_000
-     */
-    timeout?: number;
-    /**
-     * Whether or not a timeout is considered an exception.
-     * @default true
-     */
-    throwOnTimeout?: boolean;
-  });
-  private runInQueue;
-  changePort(graphvizPort: GraphvizPort): void;
-  layout<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<LayoutResult<A>>;
-  layoutProjectsView(view: ComputedProjectsView): Promise<LayoutedProjectsView>;
-  batchLayout<A extends AnyAux>(params: {
-    batch: LayoutTaskParams<A>[];
-    cancelToken?: CancellationToken | undefined;
-    onSuccess?: (task: LayoutTaskParams<A>, result: LayoutResult<A>) => void;
-    onError?: (task: LayoutTaskParams<A>, error: unknown) => void;
-  }): Promise<LayoutResult<A>[]>;
+  trace(message: string, properties: () => Promise<Record<string, unknown>>): Promise<void>;
   /**
-   * Custom backpressure
-   * (basically allow same amount of tasks to be in queue as concurrency)
+   * Log a trace values with no message.  This is useful when you
+   * want to log properties without a message, e.g., when you want to log
+   * the context of a request or an operation.
+   *
+   * ```typescript
+   * logger.trace({ method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * Note that this is a shorthand for:
+   *
+   * ```typescript
+   * logger.trace('{*}', { method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * If the properties are expensive to compute, you cannot use this shorthand
+   * and should use the following syntax instead:
+   *
+   * ```typescript
+   * logger.trace('{*}', () => ({
+   *   method: expensiveMethod(),
+   *   url: expensiveUrl(),
+   * }));
+   * ```
+   *
+   * @param properties The values to log.  Note that this does not take
+   *                   a callback.
+   * @since 0.12.0
    */
-  private waitForQueueToShrink;
-  dispose(): void;
-} //#endregion
-//#region src/graphviz/wasm/GraphvizWasmAdapter.d.ts
-//#endregion
-//#region ../language-server/dist/_chunks/module.d.mts
-//#region src/documentation/documentation-provider.d.ts
-/**
- * Provides documentation for LikeC4 AST nodes, extending JSDoc parsing
- * with specialized formatting for deployment nodes, deployed instances, and elements.
- */
-declare class LikeC4DocumentationProvider extends JSDocDocumentationProvider {
-  private parser;
-  private locator;
+  trace(properties: Record<string, unknown>): void;
   /**
-   * Creates a new documentation provider.
-   * @param services - The LikeC4 language services.
+   * Lazily log a trace message.  Use this when the message values are expensive
+   * to compute and should only be computed if the message is actually logged.
+   *
+   * ```typescript
+   * logger.trace(l => l`A trace message with ${expensiveValue()}.`);
+   * ```
+   *
+   * @param callback A callback that returns the message template prefix.
+   * @throws {TypeError} If no log record was made inside the callback.
+   * @since 0.12.0
    */
-  constructor(services: LikeC4Services);
+  trace(callback: LogCallback): void;
   /**
-   * Returns documentation for the given AST node (deployment nodes, deployed instances, elements, or JSDoc fallback).
-   * @param node - The AST node to document.
-   * @returns Formatted documentation string, or undefined if none.
+   * Log a debug message.  Use this as a template string prefix.
+   *
+   * ```typescript
+   * logger.debug `A debug message with ${value}.`;
+   * ```
+   *
+   * @param message The message template strings array.
+   * @param values The message template values.
    */
-  getDocumentation(node: AstNode): string | undefined;
-} //#endregion
-//#region src/workspace/ProjectsManager.d.ts
-type NormalizedUri = Tagged<string, 'NormalizedUri'>;
-type DocOrUri = LangiumDocument | string | URI;
-/**
- * A tagged string that represents a project folder URI (with trailing slash).
- * Used in `startsWith` checks to determine if a document belongs to a project.
- */
-type ProjectFolder = Tagged<string, 'ProjectFolder'>;
-declare function ProjectFolder(folder: URI | string): ProjectFolder;
-interface Project {
-  id: ProjectId;
-  folderUri: URI;
-  config: LikeC4ProjectConfig;
-}
-interface ProjectData extends Project {
-  id: ProjectId;
-  folder: ProjectFolder;
-  config: LikeC4ProjectConfig;
-  configUri: URI;
-  folderUri: URI;
-  exclude?: {
-    (test: string): boolean;
-  };
+  debug(message: TemplateStringsArray, ...values: readonly unknown[]): void;
   /**
-   * Resolved include paths with both URI and folder string representations.
-   * These are additional directories that are part of this project.
+   * Log a debug message with properties.
+   *
+   * ```typescript
+   * logger.debug('A debug message with {value}.', { value });
+   * ```
+   *
+   * If the properties are expensive to compute, you can pass a callback that
+   * returns the properties:
+   *
+   * ```typescript
+   * logger.debug(
+   *   'A debug message with {value}.',
+   *   () => ({ value: expensiveComputation() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties The values to replace placeholders with.  For lazy
+   *                   evaluation, this can be a callback that returns the
+   *                   properties.
    */
-  includePaths?: NonEmptyArray$1<{
-    uri: URI;
-    folder: ProjectFolder;
-  }>;
+  debug(message: string, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
   /**
-   * Normalized include configuration (paths, maxDepth, fileThreshold).
+   * Log a debug message with properties computed asynchronously.
+   *
+   * Use this when the properties require async operations to compute:
+   *
+   * ```typescript
+   * await logger.debug(
+   *   'A debug message with {value}.',
+   *   async () => ({ value: await fetchValue() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.0.0
    */
-  includeConfig: IncludeConfig;
-}
-type RegisterProjectOptions = {
-  config: LikeC4ProjectConfig | LikeC4ProjectConfigInput;
-} & ({
-  configUri: URI | string;
-} | {
-  folderUri: URI | string;
-});
-declare class ProjectsManager {
-  #private;
-  protected services: LikeC4SharedServices;
+  debug(message: string, properties: () => Promise<Record<string, unknown>>): Promise<void>;
   /**
-   * The global project ID used for all documents
-   * that are not part of a specific project.
+   * Log a debug values with no message.  This is useful when you
+   * want to log properties without a message, e.g., when you want to log
+   * the context of a request or an operation.
+   *
+   * ```typescript
+   * logger.debug({ method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * Note that this is a shorthand for:
+   *
+   * ```typescript
+   * logger.debug('{*}', { method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * If the properties are expensive to compute, you cannot use this shorthand
+   * and should use the following syntax instead:
+   *
+   * ```typescript
+   * logger.debug('{*}', () => ({
+   *   method: expensiveMethod(),
+   *   url: expensiveUrl(),
+   * }));
+   * ```
+   *
+   * @param properties The values to log.  Note that this does not take
+   *                   a callback.
+   * @since 0.11.0
    */
-  static readonly DefaultProjectId: ProjectId;
-  constructor(services: LikeC4SharedServices);
+  debug(properties: Record<string, unknown>): void;
   /**
-   * Checks if a document is excluded by workspace-level patterns.
-   * These patterns come from VS Code settings and take precedence over project-level excludes.
+   * Lazily log a debug message.  Use this when the message values are expensive
+   * to compute and should only be computed if the message is actually logged.
+   *
+   * ```typescript
+   * logger.debug(l => l`A debug message with ${expensiveValue()}.`);
+   * ```
+   *
+   * @param callback A callback that returns the message template prefix.
+   * @throws {TypeError} If no log record was made inside the callback.
    */
-  isExcludedByWorkspace(uri: NormalizedUri | URI): boolean;
+  debug(callback: LogCallback): void;
   /**
-   * Updates the workspace-level exclude patterns from VS Code settings.
-   * Called during initial server startup; dynamic changes restart the server.
+   * Log an informational message.  Use this as a template string prefix.
+   *
+   * ```typescript
+   * logger.info `An info message with ${value}.`;
+   * ```
+   *
+   * @param message The message template strings array.
+   * @param values The message template values.
    */
-  setWorkspaceExcludePatterns(patterns: string[] | undefined): void;
+  info(message: TemplateStringsArray, ...values: readonly unknown[]): void;
   /**
-   * Returns:
-   *  - configured default project ID if set
-   *  - the default project ID if there are no projects.
-   *  - the ID of the only project
-   *  - undefined if there are multiple projects.
+   * Log an informational message with properties.
+   *
+   * ```typescript
+   * logger.info('An info message with {value}.', { value });
+   * ```
+   *
+   * If the properties are expensive to compute, you can pass a callback that
+   * returns the properties:
+   *
+   * ```typescript
+   * logger.info(
+   *   'An info message with {value}.',
+   *   () => ({ value: expensiveComputation() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties The values to replace placeholders with.  For lazy
+   *                   evaluation, this can be a callback that returns the
+   *                   properties.
    */
-  get defaultProjectId(): ProjectId | undefined;
-  set defaultProjectId(id: string | ProjectId | undefined);
-  get default(): ProjectData;
-  get all(): NonEmptyReadonlyArray$1<ProjectId>;
-  getProject(arg: ProjectId | LangiumDocument): ProjectData;
+  info(message: string, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
   /**
-   * Returns all projects that overlap with the specified folder (is parent or child)
+   * Log an informational message with properties computed asynchronously.
+   *
+   * Use this when the properties require async operations to compute:
+   *
+   * ```typescript
+   * await logger.info(
+   *   'An info message with {value}.',
+   *   async () => ({ value: await fetchValue() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.0.0
    */
-  findOverlaped(folder: URI | string): ReadonlyArray<ProjectData>;
+  info(message: string, properties: () => Promise<Record<string, unknown>>): Promise<void>;
   /**
-   * Validates and ensures the project ID.
-   * If no project ID is specified, returns default project ID
-   * If there are multiple projects and default project is not set, throws an error
+   * Log an informational values with no message.  This is useful when you
+   * want to log properties without a message, e.g., when you want to log
+   * the context of a request or an operation.
+   *
+   * ```typescript
+   * logger.info({ method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * Note that this is a shorthand for:
+   *
+   * ```typescript
+   * logger.info('{*}', { method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * If the properties are expensive to compute, you cannot use this shorthand
+   * and should use the following syntax instead:
+   *
+   * ```typescript
+   * logger.info('{*}', () => ({
+   *   method: expensiveMethod(),
+   *   url: expensiveUrl(),
+   * }));
+   * ```
+   *
+   * @param properties The values to log.  Note that this does not take
+   *                   a callback.
+   * @since 0.11.0
    */
-  ensureProjectId(projectId?: ProjectId | undefined): ProjectId;
+  info(properties: Record<string, unknown>): void;
   /**
-   * Validates and ensures the project data.
-   * If projectId is not specified, returns default project
+   * Lazily log an informational message.  Use this when the message values are
+   * expensive to compute and should only be computed if the message is actually
+   * logged.
    *
-   * If there are multiple projects and default project is not set, throws an error
+   * ```typescript
+   * logger.info(l => l`An info message with ${expensiveValue()}.`);
+   * ```
    *
-   * @see ensureProjectId - to validate project ID only
+   * @param callback A callback that returns the message template prefix.
+   * @throws {TypeError} If no log record was made inside the callback.
    */
-  ensureProject(projectId?: ProjectId | undefined): ProjectData;
-  hasMultipleProjects(): boolean;
+  info(callback: LogCallback): void;
   /**
-   * Checks if given document (or URI) must be excluded from processing.
+   * Log a warning.
+   *
+   * This overload is a shorthand for logging an {@link Error} instance as a
+   * structured property.
+   *
+   * ```typescript
+   * logger.warn(new Error("Oops"));
+   * ```
+   *
+   * Note that this uses `{error.message}` as the default message template.
+   * If you want to include the stack trace in text output, include `{error}`
+   * in the message template instead.
+   *
+   * @param error The error to log.
+   * @since 2.0.0
    */
-  isExcluded(document: DocOrUri): boolean;
+  warn(error: Error): void;
   /**
-   * Checks if given document (or URI) must be excluded in the context of the project.
+   * Log a warning with additional properties.
+   *
+   * This overload is a shorthand for logging an {@link Error} instance as a
+   * structured property while also adding extra properties.
+   *
+   * ```typescript
+   * logger.warn(new Error("Oops"), { requestId });
+   * ```
+   *
+   * @param error The error to log.
+   * @param properties Additional properties to log alongside the error.
+   * @since 2.1.0
    */
-  isExcluded(projectId: ProjectId, document: DocOrUri): boolean;
+  warn(error: Error, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
   /**
-   * Checks if the specified document is included by the project:
-   * - if the document belongs to the project and is not excluded
-   * - if the document is included by the project
+   * Log a warning with additional properties computed asynchronously.
+   *
+   * @param error The error to log.
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.1.0
    */
-  isIncluded(projectId: ProjectId, document: LangiumDocument | URI | string): boolean;
+  warn(error: Error, properties: () => Promise<Record<string, unknown>>): Promise<void>;
   /**
-   * Registers likec4 project by config file.
+   * Log a warning message with an {@link Error}.
+   *
+   * ```typescript
+   * logger.warn("Failed to do something", new Error("Oops"));
+   * ```
+   *
+   * @param message The message.
+   * @param error The error to log.
+   * @since 2.0.0
    */
-  registerConfigFile(configUri: URI, cancelToken?: CancellationToken$1): Promise<ProjectData>;
+  warn(message: string, error: Error): void;
   /**
-   * Registers (or reloads) likec4 project by config file or config object.
-   * If there is some project registered at same folder, it will be reloaded.
+   * Log a warning message.  Use this as a template string prefix.
+   *
+   * ```typescript
+   * logger.warn `A warning message with ${value}.`;
+   * ```
+   *
+   * @param message The message template strings array.
+   * @param values The message template values.
    */
-  registerProject(opts: RegisterProjectOptions, cancelToken?: CancellationToken$1): Promise<ProjectData>;
+  warn(message: TemplateStringsArray, ...values: readonly unknown[]): void;
   /**
-   * Determines which project the given document belongs to.
-   * If the document does not belong to any project, returns the default project ID.
+   * Log a warning message with properties.
+   *
+   * ```typescript
+   * logger.warn('A warning message with {value}.', { value });
+   * ```
+   *
+   * If the properties are expensive to compute, you can pass a callback that
+   * returns the properties:
+   *
+   * ```typescript
+   * logger.warn(
+   *   'A warning message with {value}.',
+   *   () => ({ value: expensiveComputation() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties The values to replace placeholders with.  For lazy
+   *                   evaluation, this can be a callback that returns the
+   *                   properties.
    */
-  ownerProjectId(document: LangiumDocument | URI | string): ProjectId;
+  warn(message: string, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
   /**
-   * Returns path to the document relative to the project folder.
-   * If the document does not belong to any project, returns the document URI as string.
+   * Log a warning message with properties computed asynchronously.
+   *
+   * Use this when the properties require async operations to compute:
+   *
+   * ```typescript
+   * await logger.warn(
+   *   'A warning message with {value}.',
+   *   async () => ({ value: await fetchValue() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.0.0
    */
-  relativePath(document: LangiumDocument | URI | string): string;
+  warn(message: string, properties: () => Promise<Record<string, unknown>>): Promise<void>;
   /**
-   * Returns true if the manager is currently initializing or reloading projects.
-   * This is used to prevent duplicate reload operations.
+   * Log a warning values with no message.  This is useful when you
+   * want to log properties without a message, e.g., when you want to log
+   * the context of a request or an operation.
+   *
+   * ```typescript
+   * logger.warn({ method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * Note that this is a shorthand for:
+   *
+   * ```typescript
+   * logger.warn('{*}', { method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * If the properties are expensive to compute, you cannot use this shorthand
+   * and should use the following syntax instead:
+   *
+   * ```typescript
+   * logger.warn('{*}', () => ({
+   *   method: expensiveMethod(),
+   *   url: expensiveUrl(),
+   * }));
+   * ```
+   *
+   * @param properties The values to log.  Note that this does not take
+   *                   a callback.
+   * @since 0.11.0
    */
-  protected get isInitiatingOrReloading(): boolean;
-  reloadProjects(cancelToken?: CancellationToken$1): Promise<void>;
-  protected _reloadProjects(cancelToken?: CancellationToken$1): Promise<void>;
-  protected uniqueProjectId(name: string): ProjectId;
-  protected resetCaches(): void;
-  rebuildProject(projectId: ProjectId, cancelToken?: CancellationToken$1): Promise<void>;
+  warn(properties: Record<string, unknown>): void;
   /**
-   * Returns all include paths from all projects.
-   * Used by WorkspaceManager to scan additional directories for C4 files.
+   * Lazily log a warning message.  Use this when the message values are
+   * expensive to compute and should only be computed if the message is actually
+   * logged.
+   *
+   * ```typescript
+   * logger.warn(l => l`A warning message with ${expensiveValue()}.`);
+   * ```
+   *
+   * @param callback A callback that returns the message template prefix.
+   * @throws {TypeError} If no log record was made inside the callback.
    */
-  getAllIncludePaths(): Array<{
-    projectId: ProjectId;
-    includePath: URI;
-    includeConfig: IncludeConfig;
-  }>;
+  warn(callback: LogCallback): void;
   /**
-   * Register a listener to be called when the projects configuration has changed.
-   * @returns A disposable that can be used to unregister the callback.
+   * Log a warning.
+   *
+   * This overload is a shorthand for logging an {@link Error} instance as a
+   * structured property.
+   *
+   * ```typescript
+   * logger.warning(new Error("Oops"));
+   * ```
+   *
+   * Note that this uses `{error.message}` as the default message template.
+   * If you want to include the stack trace in text output, include `{error}`
+   * in the message template instead.
+   *
+   * @param error The error to log.
+   * @since 2.0.0
    */
-  onProjectsUpdate(callback: () => void): Disposable$1;
-  private getWorkspaceFolder;
-  private notifyListeners;
-  private updateIncludesExcludes;
-  private warnIfConfigOverride;
-} //#endregion
-//#region src/filesystem/types.d.ts
-interface FileNode extends FileSystemNode {
-  readonly isFile: true;
-  readonly isDirectory: false;
-}
-interface FileSystemProvider$1 extends FileSystemProvider {
+  warning(error: Error): void;
   /**
-   * Scans the project files for the given URI.
-   * @returns The list of file system entries that are contained within the specified directory.
+   * Log a warning with additional properties.
+   *
+   * This overload is a shorthand for logging an {@link Error} instance as a
+   * structured property while also adding extra properties.
+   *
+   * ```typescript
+   * logger.warning(new Error("Oops"), { requestId });
+   * ```
+   *
+   * @param error The error to log.
+   * @param properties Additional properties to log alongside the error.
+   * @since 2.1.0
    */
-  scanProjectFiles(folderUri: URI): Promise<FileNode[]>;
+  warning(error: Error, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
   /**
-   * Loads the project config from the given file.
-   * @returns The project config.
-   * @throws Error if the file does not exist or is not a valid project config.
+   * Log a warning with additional properties computed asynchronously.
+   *
+   * @param error The error to log.
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.1.0
    */
-  loadProjectConfig(filepath: URI): Promise<LikeC4ProjectConfig>;
+  warning(error: Error, properties: () => Promise<Record<string, unknown>>): Promise<void>;
   /**
-   * Reads the directory and returns LikeC4 files.
+   * Log a warning message with an {@link Error}.
    *
-   * @param options.recursive If true, recursively reads the directory,
-   * @param options.maxDepth Maximum depth to traverse when recursive is true (default: Infinity)
+   * ```typescript
+   * logger.warning("Failed to do something", new Error("Oops"));
+   * ```
+   *
+   * @param message The message.
+   * @param error The error to log.
+   * @since 2.0.0
    */
-  readDirectory(uri: URI, options?: {
-    recursive?: boolean;
-    maxDepth?: number;
-  }): Promise<FileNode[]>;
+  warning(message: string, error: Error): void;
   /**
-   * Finds all files in the given directory, matching the given filter.
+   * Log a warning message.  Use this as a template string prefix.
+   *
+   * ```typescript
+   * logger.warning `A warning message with ${value}.`;
+   * ```
+   *
+   * @param message The message template strings array.
+   * @param values The message template values.
+   * @since 0.12.0
    */
-  scanDirectory(directory: URI, filter: (filepath: string, isDirectory: boolean) => boolean): Promise<FileNode[]>;
+  warning(message: TemplateStringsArray, ...values: readonly unknown[]): void;
   /**
-   * Writes the content to the file system.
-   * Used by manual layouts.
+   * Log a warning message with properties.
+   *
+   * ```typescript
+   * logger.warning('A warning message with {value}.', { value });
+   * ```
+   *
+   * If the properties are expensive to compute, you can pass a callback that
+   * returns the properties:
+   *
+   * ```typescript
+   * logger.warning(
+   *   'A warning message with {value}.',
+   *   () => ({ value: expensiveComputation() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties The values to replace placeholders with.  For lazy
+   *                   evaluation, this can be a callback that returns the
+   *                   properties.
+   * @since 0.12.0
    */
-  writeFile(uri: URI, content: string): Promise<void>;
+  warning(message: string, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
   /**
-   * Deletes the file from the file system.
-   * Used by manual layouts.
-   * @return true if the file was deleted, false if the file did not exist.
+   * Log a warning message with properties computed asynchronously.
+   *
+   * Use this when the properties require async operations to compute:
+   *
+   * ```typescript
+   * await logger.warning(
+   *   'A warning message with {value}.',
+   *   async () => ({ value: await fetchValue() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.0.0
    */
-  deleteFile(uri: URI): Promise<boolean>;
-}
-interface FileSystemWatcher extends AsyncDisposable {
+  warning(message: string, properties: () => Promise<Record<string, unknown>>): Promise<void>;
   /**
-   * Watches a folder for changes and triggers a reload of the documents and projects.
+   * Log a warning values with no message.  This is useful when you
+   * want to log properties without a message, e.g., when you want to log
+   * the context of a request or an operation.
+   *
+   * ```typescript
+   * logger.warning({ method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * Note that this is a shorthand for:
+   *
+   * ```typescript
+   * logger.warning('{*}', { method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * If the properties are expensive to compute, you cannot use this shorthand
+   * and should use the following syntax instead:
+   *
+   * ```typescript
+   * logger.warning('{*}', () => ({
+   *   method: expensiveMethod(),
+   *   url: expensiveUrl(),
+   * }));
+   * ```
+   *
+   * @param properties The values to log.  Note that this does not take
+   *                   a callback.
+   * @since 0.12.0
    */
-  watch(folder: string): void;
-}
-type ManualLayoutsSnapshot = {
-  hash: string;
-  views: Record<ViewId, LayoutedView>;
-};
-type ManualLayoutUpdateEvent = {
-  updated: URI;
-  projectId: ProjectId;
-  viewId: ViewId;
-} | {
-  removed: URI;
-  projectId: ProjectId;
+  warning(properties: Record<string, unknown>): void;
   /**
-   * Missing if triggered by FS event (file was deleted)
+   * Lazily log a warning message.  Use this when the message values are
+   * expensive to compute and should only be computed if the message is actually
+   * logged.
+   *
+   * ```typescript
+   * logger.warning(l => l`A warning message with ${expensiveValue()}.`);
+   * ```
+   *
+   * @param callback A callback that returns the message template prefix.
+   * @throws {TypeError} If no log record was made inside the callback.
+   * @since 0.12.0
    */
-  viewId?: ViewId;
-};
-type ManualLayoutUpdateListener = (event: ManualLayoutUpdateEvent) => void;
-interface LikeC4ManualLayouts {
+  warning(callback: LogCallback): void;
   /**
-   * Reads a single layouted view from the file system by its URI.
-   * Used by the language server to get the current layout state.
+   * Log an error.
+   *
+   * This overload is a shorthand for logging an {@link Error} instance as a
+   * structured property.
+   *
+   * ```typescript
+   * logger.error(new Error("Oops"));
+   * ```
+   *
+   * Note that this uses `{error.message}` as the default message template.
+   * If you want to include the stack trace in text output, include `{error}`
+   * in the message template instead.
+   *
+   * @param error The error to log.
+   * @since 2.0.0
    */
-  readSnapshot(uri: URI): Promise<LayoutedView | null>;
-  read(project: Project): Promise<ManualLayoutsSnapshot | null>;
-  write(project: Project, layouted: LayoutedView): Promise<Location>;
-  remove(project: Project, view: ViewId): Promise<Location | null>;
-  clearCaches(): void;
+  error(error: Error): void;
   /**
-   * Registers a listener for manual layout updates.
-   * The listener will be called when a manual layout is created, updated, or deleted.
+   * Log an error with additional properties.
+   *
+   * This overload is a shorthand for logging an {@link Error} instance as a
+   * structured property while also adding extra properties.
+   *
+   * ```typescript
+   * logger.error(new Error("Oops"), { requestId });
+   * ```
+   *
+   * If the properties are expensive to compute, you can pass a callback that
+   * returns the properties:
+   *
+   * ```typescript
+   * logger.error(
+   *   new Error("Oops"),
+   *   () => ({ requestId: expensiveLookup() })
+   * );
+   * ```
+   *
+   * @param error The error to log.
+   * @param properties Additional properties to log alongside the error.
+   * @since 2.1.0
    */
-  onManualLayoutUpdate(listener: ManualLayoutUpdateListener): Disposable$1;
+  error(error: Error, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
   /**
-   * Handles file system updates for manual layouts.
-   * Used by the file system watcher to notify the manual layouts module of changes.
-   * @param event The file system event
+   * Log an error with additional properties computed asynchronously.
+   *
+   * Use this when the properties require async operations to compute:
+   *
+   * ```typescript
+   * await logger.error(
+   *   new Error("Oops"),
+   *   async () => ({ requestId: await fetchRequestId() })
+   * );
+   * ```
+   *
+   * @param error The error to log.
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.1.0
    */
-  handleFileSystemUpdate(event: {
-    update: URI;
-    delete?: never;
-  } | {
-    delete: URI;
-    update?: never;
-  }): Promise<void>;
-} //#endregion
-//#region src/filesystem/noop.d.ts
-//#endregion
-//#region src/formatting/LikeC4Formatter.d.ts
-type QuoteStyle = 'single' | 'double' | 'ignore' | 'auto';
-interface LikeC4FormatterOptions {
-  quoteStyle: QuoteStyle;
-}
-type ExtendedFormattingCommandType = 'normalizeQuotes';
-interface ExtendedFormattingCommand {
-  type: ExtendedFormattingCommandType;
-  region: FormattingRegion;
-}
-declare class LikeC4Formatter extends AbstractFormatter {
-  protected options: LikeC4FormatterOptions;
-  extendedFormattingCommands: ExtendedFormattingCommand[];
-  constructor(services: LikeC4Services);
-  protected doDocumentFormat(document: LangiumDocument, options: FormattingOptions, range?: Range): TextEdit[];
-  protected format(node: AstNode): void;
-  protected formatTags(node: AstNode): void;
-  protected formatDeploymentRelation(node: AstNode): void;
-  protected formatExtendDeployment(node: AstNode): void;
-  protected formatRelation(node: AstNode): void;
-  protected removeIndentFromTopLevelStatements(node: AstNode): void;
-  protected indentContentInBraces(node: AstNode): void;
-  protected appendKeywordsWithSpace(node: AstNode): void;
-  protected formatView(node: AstNode): void;
-  protected formatLeafProperty(node: AstNode): void;
-  protected formatLinkProperty(node: AstNode): void;
-  protected formatNavigateToProperty(node: AstNode): void;
-  protected formatAutolayoutProperty(node: AstNode): void;
-  protected formatMetadataProperty(node: AstNode): void;
-  protected formatElementDeclaration(node: AstNode): void;
-  protected formatExtendElement(node: AstNode): void;
-  protected formatGlobals(node: AstNode): void;
-  protected formatImports(node: AstNode): void;
-  protected formatSpecificationRule(node: AstNode): void;
-  protected formatWithPredicate(node: AstNode): void;
-  protected formatDeploymentNodeDeclaration(node: AstNode): void;
-  protected formatDeployedInstance(node: AstNode): void;
-  protected formatViewRuleGlobalStyle(node: AstNode): void;
-  protected formatViewRuleGlobalPredicate(node: AstNode): void;
-  protected formatViewRuleGroup(node: AstNode): void;
-  protected formatViewRuleStyle(node: AstNode): void;
-  protected formatWhereExpression(node: AstNode): void;
-  protected formatWhereRelationExpression(node: AstNode): void;
-  protected formatWhereElementExpression(node: AstNode): void;
-  protected formatIncludeExcludeExpressions(node: AstNode): void;
-  protected formatRelationExpression(node: AstNode): void;
-  private findPredicateExpressionRoot;
-  private on;
-  private doExtendedFormatting;
-  protected normalizeQuotes(node: AstNode): void;
-  private quotesNormalizerFactory;
-  private escapeQuotesInternalQuotes;
-  private getAutoQuoteStyle;
-  private onConfigurationUpdate;
+  error(error: Error, properties: () => Promise<Record<string, unknown>>): Promise<void>;
+  /**
+   * Log an error message with an {@link Error}.
+   *
+   * ```typescript
+   * logger.error("Failed to do something", new Error("Oops"));
+   * ```
+   *
+   * @param message The message.
+   * @param error The error to log.
+   * @since 2.0.0
+   */
+  error(message: string, error: Error): void;
+  /**
+   * Log an error message.  Use this as a template string prefix.
+   *
+   * ```typescript
+   * logger.error `An error message with ${value}.`;
+   * ```
+   *
+   * @param message The message template strings array.
+   * @param values The message template values.
+   */
+  error(message: TemplateStringsArray, ...values: readonly unknown[]): void;
+  /**
+   * Log an error message with properties.
+   *
+   * ```typescript
+   * logger.warn('An error message with {value}.', { value });
+   * ```
+   *
+   * If the properties are expensive to compute, you can pass a callback that
+   * returns the properties:
+   *
+   * ```typescript
+   * logger.error(
+   *   'An error message with {value}.',
+   *   () => ({ value: expensiveComputation() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties The values to replace placeholders with.  For lazy
+   *                   evaluation, this can be a callback that returns the
+   *                   properties.
+   */
+  error(message: string, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
+  /**
+   * Log an error message with properties computed asynchronously.
+   *
+   * Use this when the properties require async operations to compute:
+   *
+   * ```typescript
+   * await logger.error(
+   *   'An error message with {value}.',
+   *   async () => ({ value: await fetchValue() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.0.0
+   */
+  error(message: string, properties: () => Promise<Record<string, unknown>>): Promise<void>;
+  /**
+   * Log an error values with no message.  This is useful when you
+   * want to log properties without a message, e.g., when you want to log
+   * the context of a request or an operation.
+   *
+   * ```typescript
+   * logger.error({ method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * Note that this is a shorthand for:
+   *
+   * ```typescript
+   * logger.error('{*}', { method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * If the properties are expensive to compute, you cannot use this shorthand
+   * and should use the following syntax instead:
+   *
+   * ```typescript
+   * logger.error('{*}', () => ({
+   *   method: expensiveMethod(),
+   *   url: expensiveUrl(),
+   * }));
+   * ```
+   *
+   * @param properties The values to log.  Note that this does not take
+   *                   a callback.
+   * @since 0.11.0
+   */
+  error(properties: Record<string, unknown>): void;
+  /**
+   * Lazily log an error message.  Use this when the message values are
+   * expensive to compute and should only be computed if the message is actually
+   * logged.
+   *
+   * ```typescript
+   * logger.error(l => l`An error message with ${expensiveValue()}.`);
+   * ```
+   *
+   * @param callback A callback that returns the message template prefix.
+   * @throws {TypeError} If no log record was made inside the callback.
+   */
+  error(callback: LogCallback): void;
+  /**
+   * Log a fatal error.
+   *
+   * This overload is a shorthand for logging an {@link Error} instance as a
+   * structured property.
+   *
+   * ```typescript
+   * logger.fatal(new Error("Oops"));
+   * ```
+   *
+   * Note that this uses `{error.message}` as the default message template.
+   * If you want to include the stack trace in text output, include `{error}`
+   * in the message template instead.
+   *
+   * @param error The error to log.
+   * @since 2.0.0
+   */
+  fatal(error: Error): void;
+  /**
+   * Log a fatal error with additional properties.
+   *
+   * This overload is a shorthand for logging an {@link Error} instance as a
+   * structured property while also adding extra properties.
+   *
+   * ```typescript
+   * logger.fatal(new Error("Oops"), { requestId });
+   * ```
+   *
+   * @param error The error to log.
+   * @param properties Additional properties to log alongside the error.
+   * @since 2.1.0
+   */
+  fatal(error: Error, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
+  /**
+   * Log a fatal error with additional properties computed asynchronously.
+   *
+   * @param error The error to log.
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.1.0
+   */
+  fatal(error: Error, properties: () => Promise<Record<string, unknown>>): Promise<void>;
+  /**
+   * Log a fatal error message with an {@link Error}.
+   *
+   * ```typescript
+   * logger.fatal("Failed to do something", new Error("Oops"));
+   * ```
+   *
+   * @param message The message.
+   * @param error The error to log.
+   * @since 2.0.0
+   */
+  fatal(message: string, error: Error): void;
+  /**
+   * Log a fatal error message.  Use this as a template string prefix.
+   *
+   * ```typescript
+   * logger.fatal `A fatal error message with ${value}.`;
+   * ```
+   *
+   * @param message The message template strings array.
+   * @param values The message template values.
+   */
+  fatal(message: TemplateStringsArray, ...values: readonly unknown[]): void;
+  /**
+   * Log a fatal error message with properties.
+   *
+   * ```typescript
+   * logger.warn('A fatal error message with {value}.', { value });
+   * ```
+   *
+   * If the properties are expensive to compute, you can pass a callback that
+   * returns the properties:
+   *
+   * ```typescript
+   * logger.fatal(
+   *   'A fatal error message with {value}.',
+   *   () => ({ value: expensiveComputation() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties The values to replace placeholders with.  For lazy
+   *                   evaluation, this can be a callback that returns the
+   *                   properties.
+   */
+  fatal(message: string, properties?: Record<string, unknown> | (() => Record<string, unknown>)): void;
+  /**
+   * Log a fatal error message with properties computed asynchronously.
+   *
+   * Use this when the properties require async operations to compute:
+   *
+   * ```typescript
+   * await logger.fatal(
+   *   'A fatal error message with {value}.',
+   *   async () => ({ value: await fetchValue() })
+   * );
+   * ```
+   *
+   * @param message The message template.  Placeholders to be replaced with
+   *                `values` are indicated by keys in curly braces (e.g.,
+   *                `{value}`).
+   * @param properties An async callback that returns the properties.
+   * @returns A promise that resolves when the log is written.
+   * @since 2.0.0
+   */
+  fatal(message: string, properties: () => Promise<Record<string, unknown>>): Promise<void>;
+  /**
+   * Log a fatal error values with no message.  This is useful when you
+   * want to log properties without a message, e.g., when you want to log
+   * the context of a request or an operation.
+   *
+   * ```typescript
+   * logger.fatal({ method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * Note that this is a shorthand for:
+   *
+   * ```typescript
+   * logger.fatal('{*}', { method: 'GET', url: '/api/v1/resource' });
+   * ```
+   *
+   * If the properties are expensive to compute, you cannot use this shorthand
+   * and should use the following syntax instead:
+   *
+   * ```typescript
+   * logger.fatal('{*}', () => ({
+   *   method: expensiveMethod(),
+   *   url: expensiveUrl(),
+   * }));
+   * ```
+   *
+   * @param properties The values to log.  Note that this does not take
+   *                   a callback.
+   * @since 0.11.0
+   */
+  fatal(properties: Record<string, unknown>): void;
+  /**
+   * Lazily log a fatal error message.  Use this when the message values are
+   * expensive to compute and should only be computed if the message is actually
+   * logged.
+   *
+   * ```typescript
+   * logger.fatal(l => l`A fatal error message with ${expensiveValue()}.`);
+   * ```
+   *
+   * @param callback A callback that returns the message template prefix.
+   * @throws {TypeError} If no log record was made inside the callback.
+   */
+  fatal(callback: LogCallback): void;
+  /**
+   * Emits a log record with custom fields while using this logger's
+   * category.
+   *
+   * This is a low-level API for integration scenarios where you need full
+   * control over the log record, particularly for preserving timestamps
+   * from external systems.
+   *
+   * ```typescript
+   * const logger = getLogger(["my-app", "integration"]);
+   *
+   * // Emit a log with a custom timestamp
+   * logger.emit({
+   *   timestamp: kafkaLog.originalTimestamp,
+   *   level: "info",
+   *   message: [kafkaLog.message],
+   *   rawMessage: kafkaLog.message,
+   *   properties: {
+   *     source: "kafka",
+   *     partition: kafkaLog.partition,
+   *     offset: kafkaLog.offset,
+   *   },
+   * });
+   * ```
+   *
+   * @param record Log record without category field (category comes from
+   *               the logger instance)
+   * @since 1.1.0
+   */
+  emit(record: Omit<LogRecord, "category">): void;
+  /**
+   * Check if a message of the given severity level would be processed by
+   * this logger.
+   *
+   * This is useful for conditionally executing expensive computations
+   * before logging, particularly for async operations where lazy
+   * evaluation callbacks cannot be used:
+   *
+   * ```typescript
+   * if (logger.isEnabledFor("debug")) {
+   *   const result = await expensiveAsync();
+   *   logger.debug("Result: {result}", { result });
+   * }
+   * ```
+   *
+   * @param level The log level to check.
+   * @returns `true` if a message of the given level would be logged,
+   *          `false` otherwise.
+   * @since 2.0.0
+   */
+  isEnabledFor(level: LogLevel): boolean;
+}
+/**
+ * A logging callback function.  It is used to defer the computation of a
+ * message template until it is actually logged.
+ * @param prefix The message template prefix.
+ * @returns The rendered message array.
+ */
+type LogCallback = (prefix: LogTemplatePrefix) => unknown[];
+/**
+ * A logging template prefix function.  It is used to log a message in
+ * a {@link LogCallback} function.
+ * @param message The message template strings array.
+ * @param values The message template values.
+ * @returns The rendered message array.
+ */
+type LogTemplatePrefix = (message: TemplateStringsArray, ...values: unknown[]) => unknown[];
+/**
+ * A function type for logging methods in the {@link Logger} interface.
+ * @since 1.0.0
+ */
+//#endregion
+//#region ../layouts/dist/_chunks/types.d.mts
+/**
+ * invisible edge added by AI to enforce better layout
+ */
+interface AIEnforcementEdge {
+  source: NodeId;
+  target: NodeId;
+  weight?: number;
+  minlen?: number;
+}
+/**
+ * Complete set of AI-generated layout hints.
+ * This is the JSON schema the LLM must produce.
+ */
+interface AILayoutHints {
+  direction?: 'TB' | 'BT' | 'LR' | 'RL';
+  ranks: ReadonlyArray<{
+    rank: 'same' | 'source' | 'sink' | 'min' | 'max';
+    nodes: NonEmptyArray<NodeId>;
+  }>;
+  edgeWeight: Record<EdgeId, number>;
+  edgeMinlen: Record<EdgeId, number>;
+  /**
+   * These edges should be reversed in DOT
+   * Unique array of EdgeIds.
+   */
+  reverseRank?: NonEmptyReadonlyArray<EdgeId>;
+  /**
+   * These edges should be excluded, i.e. `constraint=false` in Graphviz, to allow more flexible layouts.
+   * Unique array of EdgeIds.
+   */
+  excludeFromRanking?: NonEmptyReadonlyArray<EdgeId>;
+  /**
+   * Suggested order of edges for DOT output, to influence edge routing.
+   */
+  edgeOrder?: NonEmptyReadonlyArray<EdgeId>;
+  /**
+   * Suggested order of nodes for DOT output, to influence node placement.
+   */
+  nodeOrder?: NonEmptyReadonlyArray<NodeId>;
+  /**
+   * Invisible edges added by AI to enforce better layout
+   */
+  invisibleEdges?: NonEmptyReadonlyArray<AIEnforcementEdge>;
+  /**
+   * LLM reasoning for debugging/display
+   */
+  reasoning: string;
+} //#endregion
+//#endregion
+//#region ../language-server/dist/_chunks/protocol.d.mts
+/**
+ * When server requests to open a likec4 preview panel
+ * (available only in the editor).
+ * (not the best place, but seems to be working)
+ */
+declare namespace DidRequestOpenViewNotification {
+  type Params = {
+    viewId: ViewId$1;
+    projectId: ProjectId$1;
+  };
+  const type: NotificationType<Params>;
+  type Type = typeof type;
+}
+/**
+ * Request to fetch the computed model data
+ * If LSP has multiple projects, the projectId is required.
+ * otherwise throws an error.
+ */
+/**
+ * Request to locate an element, relation, deployment or view.
+ * If LSP has multiple projects, the projectId is required.
+ */
+declare namespace Locate {
+  type Params =
+  /**
+   * Locate an element by its fqn
+   */
+  {
+    element: Fqn$1;
+    projectId?: string | undefined;
+    property?: string;
+  }
+  /**
+   * Locate a relation by its id
+   */
+  | {
+    projectId?: string | undefined;
+    relation: RelationId;
+  }
+  /**
+   * Locate a deployment by its fqn
+   */
+  | {
+    deployment: DeploymentFqn;
+    projectId?: string | undefined;
+    property?: string;
+  }
+  /**
+   * Locate a step in a dynamic view by its astPath
+   */
+  | {
+    view: ViewId$1;
+    astPath: string;
+    projectId?: string | undefined;
+  }
+  /**
+   * Locate a view by its id
+   */
+  | {
+    view: ViewId$1;
+    projectId?: string | undefined;
+  };
+  type Res = Location | null;
+  const req: RequestType<Params, Res, void>;
+  type Req = typeof req;
+}
+/**
+ * Request to change the view
+ * If LSP has multiple projects, the projectId is required.
+ */
+declare namespace ChangeView {
+  type Params = {
+    viewId: ViewId$1;
+    change: ViewChange;
+    projectId?: string | undefined;
+  };
+  type Res = {
+    success: true;
+    location: Location | null;
+  } | {
+    success: false;
+    location?: Location | null;
+    error: string;
+  };
+  const req: RequestType<Params, Res, void>;
+  type Req = typeof req;
+}
+/**
+ * Request to fetch telemetry metrics
+ */
+//#endregion
+//#region ../layouts/dist/_chunks/GraphvizLayoter.d.mts
+//#region src/graphviz/types.d.ts
+/**
+ * Partially implements CancellationToken interface from vscode-jsonrpc
+ */
+type CancellationToken = {
+  /**
+   * Is `true` when the token has been cancelled, `false` otherwise.
+   */
+  readonly isCancellationRequested: boolean;
+};
+declare module 'ts-graphviz' {
+  namespace GraphAttributeKey {
+    interface $values extends $keywords<'likec4_viewId'> {}
+  }
+  namespace ClusterSubgraphAttributeKey {
+    interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_level' | 'likec4_depth'> {}
+  }
+  namespace NodeAttributeKey {
+    interface $values extends $keywords<'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_project' | 'likec4_level'> {}
+  }
+  namespace EdgeAttributeKey {
+    interface $values extends $keywords<'likec4_id' | 'likec4_project'> {}
+  }
+  namespace Attribute {
+    interface $keys extends $keywords<'likec4_viewId' | 'likec4_type' | 'likec4_path' | 'likec4_id' | 'likec4_project' | 'likec4_level' | 'likec4_depth'> {}
+    interface $types {
+      likec4_viewId: string;
+      likec4_type: 'folder' | 'file' | 'view';
+      likec4_path: string;
+      likec4_id: string;
+      likec4_project: string;
+      likec4_level: number;
+      likec4_depth: number;
+    }
+  }
+}
+type DotSource = Tagged<string, 'DotSource'>; //#endregion
+//#region src/graphviz/types-dot.d.ts
+type GvNodeName = Tagged<string, 'GvNodeName'>;
+type GvId = Tagged<number, 'GvId'>;
+type Point = [x: number, y: number];
+interface GraphvizJson {
+  name: GvNodeName;
+  directed: boolean;
+  strict: boolean;
+  _draw_: GraphvizJson.Draw[];
+  bb: string;
+  compound: string;
+  fontname: string;
+  fontsize: string;
+  label: string;
+  nodesep: string;
+  outputorder: string;
+  rankdir: string;
+  ranksep: string;
+  splines: string;
+  xdotversion: string;
+  _subgraph_cnt: number;
+  objects?: GraphvizJson.GvObject[];
+  edges?: GraphvizJson.Edge[];
+}
+declare namespace GraphvizJson {
+  interface Draw {
+    op: string;
+    grad: string;
+    color: string;
+    points: Point[];
+  }
+  interface Draw2 {
+    op: string;
+    grad: string;
+    color: string;
+    points: Point[];
+  }
+  namespace DrawOps {
+    type Style = {
+      op: 'S';
+      style: string;
+    };
+    type BSpline = {
+      op: 'b' | 'B';
+      points: Point[];
+    };
+    type Color = {
+      op: 'c';
+      grad: string;
+      color: string;
+    };
+    type Polygon = {
+      op: 'p' | 'P';
+      points: Point[];
+    };
+  }
+  type DrawOp = DrawOps.Style | DrawOps.BSpline | DrawOps.Color | DrawOps.Polygon;
+  type LabelDrawOps = {
+    op: 'F';
+    size: number;
+    face: string;
+  } | {
+    op: 'c';
+    color: string;
+  } | {
+    op: 't';
+    fontchar: number;
+  } | {
+    op: 'T';
+    pt: Point;
+    align: 'l' | 'r' | 'c';
+    width: number;
+    text: string;
+  };
+  type GvObject = GvNodeObject | GvSubgraph;
+  interface GvSubgraph {
+    bb: string;
+    label?: string;
+    compound: 'true';
+    _ldraw_?: LabelDrawOps[];
+    likec4_type?: 'folder' | 'file';
+    likec4_path?: string;
+    likec4_id?: Fqn$1;
+    likec4_level?: number;
+    likec4_depth?: number;
+    _gvid: GvId;
+    subgraphs?: GvId[];
+    nodes?: GvId[];
+    edges?: GvId[];
+  }
+  interface GvNodeObject {
+    _draw_: Draw[];
+    _ldraw_?: LabelDrawOps[];
+    likec4_type?: 'folder' | 'file' | 'view';
+    likec4_path?: string;
+    likec4_id?: Fqn$1;
+    likec4_level?: number;
+    _gvid: GvId;
+    height: string;
+    pos: string;
+    shape: 'rect';
+    width: string;
+    label?: string;
+  }
+  interface Draw3 {
+    op: string;
+    grad: string;
+    color: string;
+    points: Point[];
+  }
+  interface Hdraw {
+    op: string;
+    style: string;
+    grad: string;
+    color: string;
+    points: Point[];
+  }
+  interface Edge {
+    _gvid: GvId;
+    tail: GvId;
+    head: GvId;
+    dir?: 'forward' | 'back' | 'both' | 'none';
+    _draw_: DrawOp[];
+    _hdraw_?: DrawOp[];
+    _tdraw_?: DrawOp[];
+    _ldraw_?: LabelDrawOps[];
+    _tldraw_?: LabelDrawOps[];
+    _hldraw_?: LabelDrawOps[];
+    fontname: string;
+    fontsize: string;
+    likec4_id?: EdgeId$1;
+    label: string;
+    lp: string;
+    nojustify?: 'true' | 'false';
+    pos?: string;
+  }
+} //#endregion
+//#region src/graphviz/GraphvizLayoter.d.ts
+interface GraphvizPort extends Disposable {
+  get name(): string;
+  get concurrency(): number;
+  unflatten(dot: DotSource): Promise<DotSource>;
+  acyclic(dot: DotSource): Promise<DotSource>;
+  layoutJson(dot: DotSource): Promise<string>;
+  svg(dot: DotSource): Promise<string>;
+  dispose(): void;
+}
+type LayoutTaskParams<A extends aux$1.Any = aux$1.Any> = {
+  view: ComputedView<A>;
+  styles: LikeC4Styles$1;
+};
+type LayoutResult<A extends aux$1.Any = aux$1.Any> = {
+  dot: DotSource;
+  diagram: DiagramView<A>;
+};
+declare class GraphvizLayouter implements Disposable {
+  private graphviz;
+  constructor(graphviz?: GraphvizPort);
+  dispose(): void;
+  [Symbol.dispose](): void;
+  get graphvizPort(): GraphvizPort;
+  changePort(graphviz: GraphvizPort): void;
+  /**
+   * Generates DOT source for the given view and styles.
+   * If `hints` are provided, they will be used to influence the layout (e.g. by specifying node/edge order).
+   * This method does not perform unflattening or any other post-processing on the DOT output, so it may be used for debugging or to generate DOT for external processing.
+   */
+  printToDot(params: LayoutTaskParams, hints?: AILayoutHints): DotSource;
+  protected newScopedLogger(operation: string): any;
+  dotToJson(dot: DotSource): Promise<GraphvizJson>;
+  layout<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<LayoutResult<A>>;
+  aiLayout<A extends AnyAux>({
+    view,
+    styles
+  }: LayoutTaskParams<A>, hints: AILayoutHints): Promise<LayoutResult<A>>;
+  svg<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<{
+    svg: string;
+    dot: DotSource;
+  }>;
+  dot<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<DotSource>;
+  layoutProjectsView(view: ComputedProjectsView): Promise<LayoutedProjectsView>;
+} //#endregion
+//#endregion
+//#region ../layouts/dist/index.d.mts
+//#region src/graphviz/QueueGraphvizLayoter.d.ts
+declare class QueueGraphvizLayoter extends GraphvizLayouter {
+  private queue;
+  private isProcessingBatch;
+  constructor(options?: {
+    graphviz?: GraphvizPort;
+    /**
+     * Concurrency limit.
+     * Minimum: `1`.
+     * @default 2
+     */
+    concurrency?: number;
+    /**
+     * Per-operation timeout in milliseconds. Operations fulfill once `timeout` elapses if they haven't already.
+     * @default 20_000
+     */
+    timeout?: number;
+    /**
+     * Whether or not a timeout is considered an exception.
+     * @default true
+     */
+    throwOnTimeout?: boolean;
+  });
+  private runInQueue;
+  changePort(graphvizPort: GraphvizPort): void;
+  layout<A extends AnyAux>(params: LayoutTaskParams<A>): Promise<LayoutResult<A>>;
+  layoutProjectsView(view: ComputedProjectsView): Promise<LayoutedProjectsView>;
+  batchLayout<A extends AnyAux>(params: {
+    batch: LayoutTaskParams<A>[];
+    cancelToken?: CancellationToken | undefined;
+    onSuccess?: (task: LayoutTaskParams<A>, result: LayoutResult<A>) => void;
+    onError?: (task: LayoutTaskParams<A>, error: unknown) => void;
+  }): Promise<LayoutResult<A>[]>;
+  /**
+   * Custom backpressure
+   * (basically allow same amount of tasks to be in queue as concurrency)
+   */
+  private waitForQueueToShrink;
+  dispose(): void;
+} //#endregion
+//#region src/graphviz/wasm/GraphvizWasmAdapter.d.ts
+//#endregion
+//#region ../language-server/dist/_chunks/module.d.mts
+//#region src/documentation/documentation-provider.d.ts
+/**
+ * Provides documentation for LikeC4 AST nodes, extending JSDoc parsing
+ * with specialized formatting for deployment nodes, deployed instances, and elements.
+ */
+declare class LikeC4DocumentationProvider extends JSDocDocumentationProvider {
+  private parser;
+  private locator;
+  /**
+   * Creates a new documentation provider.
+   * @param services - The LikeC4 language services.
+   */
+  constructor(services: LikeC4Services);
+  /**
+   * Returns documentation for the given AST node (deployment nodes, deployed instances, elements, or JSDoc fallback).
+   * @param node - The AST node to document.
+   * @returns Formatted documentation string, or undefined if none.
+   */
+  getDocumentation(node: AstNode): string | undefined;
+} //#endregion
+//#region src/utils/disposable.d.ts
+declare abstract class ADisposable implements Disposable$1 {
+  protected toDispose: Disposable$1[];
+  protected isDisposed: boolean;
+  onDispose(...disposable: Disposable$1[]): void;
+  dispose(): void;
+  protected throwIfDisposed(): void;
 } //#endregion
 //#region src/generated/ast.d.ts
 type AnyProperty = DynamicViewProperty | ElementProperty | NavigateToProperty | NotationProperty | NotesProperty | RelationProperty | RelationshipStyleProperty | StringProperty | StyleProperty | ViewProperty;
@@ -1029,9 +1871,9 @@ interface DynamicViewIncludePredicate extends AstNode {
 }
 declare const DynamicViewIncludePredicate = "DynamicViewIncludePredicate";
 interface DynamicViewParallelSteps extends AstNode {
-  readonly $container: DynamicViewBody;
+  readonly $container: DynamicViewBody | DynamicViewParallelSteps;
   readonly $type: 'DynamicViewParallelSteps';
-  steps: Array<DynamicViewStep>;
+  steps: Array<DynamicViewParallelSteps | DynamicViewStep>;
 }
 declare const DynamicViewParallelSteps = "DynamicViewParallelSteps";
 interface DynamicViewRef extends AstNode {
@@ -2124,95 +2966,402 @@ interface ParsedAstExtendRelation {
     [key: string]: string | string[];
   };
 }
-interface ParsedAstRelation {
-  id: c4.RelationId;
-  astPath: string;
-  source: c4.FqnRef.ModelRef;
-  target: c4.FqnRef.ModelRef;
-  kind?: c4.RelationshipKind;
-  tags?: c4.NonEmptyArray<c4.Tag>;
-  title: string;
-  description?: c4.MarkdownOrString;
-  technology?: string;
-  color?: c4.Color;
-  line?: c4.RelationshipLineType;
-  head?: c4.RelationshipArrowType;
-  tail?: c4.RelationshipArrowType;
-  links?: c4.NonEmptyArray<c4.Link>;
-  navigateTo?: c4.ViewId;
-  metadata?: {
-    [key: string]: string | string[];
-  };
+interface ParsedAstRelation {
+  id: c4.RelationId;
+  astPath: string;
+  source: c4.FqnRef.ModelRef;
+  target: c4.FqnRef.ModelRef;
+  kind?: c4.RelationshipKind;
+  tags?: c4.NonEmptyArray<c4.Tag>;
+  title: string;
+  description?: c4.MarkdownOrString;
+  technology?: string;
+  color?: c4.Color;
+  line?: c4.RelationshipLineType;
+  head?: c4.RelationshipArrowType;
+  tail?: c4.RelationshipArrowType;
+  links?: c4.NonEmptyArray<c4.Link>;
+  navigateTo?: c4.ViewId;
+  metadata?: {
+    [key: string]: string | string[];
+  };
+}
+type ParsedAstDeployment = Simplify<MergeExclusive<ParsedAstDeployment.Node, ParsedAstDeployment.Instance>>;
+declare namespace ParsedAstDeployment {
+  type Node = c4.DeploymentNode;
+  type Instance = Omit<c4.DeployedInstance, 'element'> & {
+    readonly element: c4.FqnRef.ModelRef;
+  };
+}
+type ParsedAstDeploymentRelation = c4.DeploymentRelationship & {
+  astPath: string;
+};
+type ParsedAstGlobals = Writable<c4.ModelGlobals>;
+interface ParsedAstElementView {
+  id: c4.ViewId;
+  viewOf?: c4.Fqn;
+  extends?: c4.ViewId;
+  astPath: string;
+  title: string | null;
+  description: c4.MarkdownOrString | null;
+  tags: c4.NonEmptyArray<c4.Tag> | null;
+  links: c4.NonEmptyArray<c4.Link> | null;
+  rules: c4.ElementViewRule[];
+}
+interface ParsedAstDynamicView {
+  id: c4.ViewId;
+  astPath: string;
+  title: string | null;
+  description: c4.MarkdownOrString | null;
+  tags: c4.NonEmptyArray<c4.Tag> | null;
+  links: c4.NonEmptyArray<c4.Link> | null;
+  steps: c4.DynamicViewStep[];
+  rules: Array<c4.DynamicViewRule>;
+  variant: c4.DynamicViewDisplayVariant | undefined;
+}
+interface ParsedAstDeploymentView {
+  id: c4.ViewId;
+  astPath: string;
+  title: string | null;
+  description: c4.MarkdownOrString | null;
+  tags: c4.NonEmptyArray<c4.Tag> | null;
+  links: c4.NonEmptyArray<c4.Link> | null;
+  rules: Array<c4.DeploymentViewRule>;
+}
+type ParsedAstView = ParsedAstElementView | ParsedAstDynamicView | ParsedAstDeploymentView;
+interface AstNodeDescriptionWithFqn extends AstNodeDescription {
+  likec4ProjectId: c4.ProjectId;
+  id: c4.Fqn;
+}
+type LikeC4AstNode = ValueOf<ConditionalPick<LikeC4AstType, AstNode>>;
+type LikeC4DocumentDiagnostic = Diagnostic & DiagnosticInfo<LikeC4AstNode>;
+interface LikeC4DocumentProps {
+  diagnostics?: Array<LikeC4DocumentDiagnostic>;
+  c4Specification?: ParsedAstSpecification;
+  c4Elements?: ParsedAstElement[];
+  c4ExtendElements?: ParsedAstExtend[];
+  c4ExtendDeployments?: ParsedAstExtend[];
+  c4ExtendRelations?: ParsedAstExtendRelation[];
+  c4Relations?: ParsedAstRelation[];
+  c4Globals?: ParsedAstGlobals;
+  c4Views?: ParsedAstView[];
+  c4Deployments?: ParsedAstDeployment[];
+  c4DeploymentRelations?: ParsedAstDeploymentRelation[];
+  c4Imports?: MultiMap<c4.ProjectId, c4.Fqn, Set<c4.Fqn>>;
+}
+type LikeC4GrammarDocument = Omit<LangiumDocument<LikeC4Grammar>, 'diagnostics'>;
+interface LikeC4LangiumDocument extends LikeC4GrammarDocument, LikeC4DocumentProps {
+  likec4ProjectId: c4.ProjectId;
+}
+interface ParsedLikeC4LangiumDocument extends LikeC4GrammarDocument, Required<LikeC4DocumentProps> {
+  likec4ProjectId: c4.ProjectId;
+} //#endregion
+//#region src/workspace/ProjectsManager.d.ts
+type NormalizedUri = Tagged<string, 'NormalizedUri'>;
+type DocOrUri = LangiumDocument | string | URI;
+/**
+ * A tagged string that represents a project folder URI (with trailing slash).
+ * Used in `startsWith` checks to determine if a document belongs to a project.
+ */
+type ProjectFolder = Tagged<string, 'ProjectFolder'>;
+declare function ProjectFolder(folder: URI | string): ProjectFolder;
+interface Project {
+  id: ProjectId;
+  folderUri: URI;
+  config: LikeC4ProjectConfig;
+}
+interface ProjectData extends Project {
+  id: ProjectId;
+  folder: ProjectFolder;
+  config: LikeC4ProjectConfig;
+  configUri: URI;
+  folderUri: URI;
+  exclude?: {
+    (test: string): boolean;
+  };
+  /**
+   * Resolved include paths with both URI and folder string representations.
+   * These are additional directories that are part of this project.
+   */
+  includePaths?: NonEmptyArray$1<{
+    uri: URI;
+    folder: ProjectFolder;
+  }>;
+  /**
+   * Normalized include configuration (paths, maxDepth, fileThreshold).
+   */
+  includeConfig: IncludeConfig;
+}
+type RegisterProjectOptions = {
+  config: LikeC4ProjectConfig | LikeC4ProjectConfigInput;
+} & ({
+  configUri: URI | string;
+} | {
+  folderUri: URI | string;
+});
+declare class ProjectsManager extends ADisposable {
+  #private;
+  protected services: LikeC4SharedServices;
+  /**
+   * The global project ID used for all documents
+   * that are not part of a specific project.
+   */
+  static readonly DefaultProjectId: ProjectId;
+  constructor(services: LikeC4SharedServices);
+  /**
+   * Checks if a document is excluded by workspace-level patterns.
+   * These patterns come from VS Code settings and take precedence over project-level excludes.
+   */
+  isExcludedByWorkspace(uri: NormalizedUri | URI): boolean;
+  /**
+   * Updates the workspace-level exclude patterns from VS Code settings.
+   * Called during initial server startup; dynamic changes restart the server.
+   */
+  setWorkspaceExcludePatterns(patterns: string[] | undefined): void;
+  /**
+   * Returns:
+   *  - configured default project ID if set
+   *  - the default project ID if there are no projects.
+   *  - the ID of the only project
+   *  - undefined if there are multiple projects.
+   */
+  get defaultProjectId(): ProjectId | undefined;
+  set defaultProjectId(id: string | ProjectId | undefined);
+  get default(): ProjectData;
+  get all(): NonEmptyReadonlyArray$1<ProjectId>;
+  getProject(arg: ProjectId | LangiumDocument): ProjectData;
+  /**
+   * Returns all projects that overlap with the specified folder (is parent or child)
+   */
+  findOverlaped(folder: URI | string): ReadonlyArray<ProjectData>;
+  /**
+   * Validates and ensures the project ID.
+   * If no project ID is specified, returns default project ID
+   * If there are multiple projects and default project is not set, throws an error
+   */
+  ensureProjectId(projectId?: ProjectId | undefined): ProjectId;
+  /**
+   * Validates and ensures the project data.
+   * If projectId is not specified, returns default project
+   *
+   * If there are multiple projects and default project is not set, throws an error
+   *
+   * @see ensureProjectId - to validate project ID only
+   */
+  ensureProject(projectId?: ProjectId | undefined): ProjectData;
+  hasMultipleProjects(): boolean;
+  /**
+   * Checks if given document (or URI) must be excluded from processing.
+   */
+  isExcluded(document: DocOrUri): boolean;
+  /**
+   * Checks if given document (or URI) must be excluded in the context of the project.
+   */
+  isExcluded(projectId: ProjectId, document: DocOrUri): boolean;
+  /**
+   * Checks if the specified document is included by the project:
+   * - if the document belongs to the project and is not excluded
+   * - if the document is included by the project
+   */
+  isIncluded(projectId: ProjectId, document: LangiumDocument | URI | string): boolean;
+  /**
+   * Registers likec4 project by config file.
+   */
+  registerConfigFile(configUri: URI, cancelToken?: CancellationToken$1): Promise<ProjectData>;
+  /**
+   * Registers (or reloads) likec4 project by config file or config object.
+   * If there is some project registered at same folder, it will be reloaded.
+   */
+  registerProject(opts: RegisterProjectOptions, cancelToken?: CancellationToken$1): Promise<ProjectData>;
+  /**
+   * Determines which project the given document belongs to.
+   * If the document does not belong to any project, returns the default project ID.
+   */
+  ownerProjectId(document: LangiumDocument | URI | string): ProjectId;
+  /**
+   * Returns path to the document relative to the project folder.
+   * If the document does not belong to any project, returns the document URI as string.
+   */
+  relativePath(document: LangiumDocument | URI | string): string;
+  /**
+   * Returns true if the manager is currently initializing or reloading projects.
+   * This is used to prevent duplicate reload operations.
+   */
+  protected get isInitiatingOrReloading(): boolean;
+  reloadProjects(cancelToken?: CancellationToken$1): Promise<void>;
+  protected _reloadProjects(cancelToken?: CancellationToken$1): Promise<void>;
+  protected uniqueProjectId(name: string): ProjectId;
+  protected resetCaches(): void;
+  rebuildProject(projectId: ProjectId, cancelToken?: CancellationToken$1): Promise<void>;
+  /**
+   * Returns all include paths from all projects.
+   * Used by WorkspaceManager to scan additional directories for C4 files.
+   */
+  getAllIncludePaths(): Array<{
+    projectId: ProjectId;
+    includePath: URI;
+    includeConfig: IncludeConfig;
+  }>;
+  /**
+   * Register a listener to be called when the projects configuration has changed.
+   * @returns A disposable that can be used to unregister the callback.
+   */
+  onProjectsUpdate(callback: () => void): Disposable$1;
+  private getWorkspaceFolder;
+  private notifyListeners;
+  private updateIncludesExcludes;
+  private warnIfConfigOverride;
+} //#endregion
+//#region src/filesystem/types.d.ts
+interface FileNode extends FileSystemNode {
+  readonly isFile: true;
+  readonly isDirectory: false;
+}
+interface FileSystemProvider$1 extends FileSystemProvider {
+  /**
+   * Scans the project files for the given URI.
+   * @returns The list of file system entries that are contained within the specified directory.
+   */
+  scanProjectFiles(folderUri: URI): Promise<FileNode[]>;
+  /**
+   * Loads the project config from the given file.
+   * @returns The project config.
+   * @throws Error if the file does not exist or is not a valid project config.
+   */
+  loadProjectConfig(filepath: URI): Promise<LikeC4ProjectConfig>;
+  /**
+   * Reads the directory and returns LikeC4 files.
+   *
+   * @param options.recursive If true, recursively reads the directory,
+   * @param options.maxDepth Maximum depth to traverse when recursive is true (default: Infinity)
+   */
+  readDirectory(uri: URI, options?: {
+    recursive?: boolean;
+    maxDepth?: number;
+  }): Promise<FileNode[]>;
+  /**
+   * Finds all files in the given directory, matching the given filter.
+   */
+  scanDirectory(directory: URI, filter: (filepath: string, isDirectory: boolean) => boolean): Promise<FileNode[]>;
+  /**
+   * Writes the content to the file system.
+   * Used by manual layouts.
+   */
+  writeFile(uri: URI, content: string): Promise<void>;
+  /**
+   * Deletes the file from the file system.
+   * Used by manual layouts.
+   * @return true if the file was deleted, false if the file did not exist.
+   */
+  deleteFile(uri: URI): Promise<boolean>;
 }
-type ParsedAstDeployment = Simplify<MergeExclusive<ParsedAstDeployment.Node, ParsedAstDeployment.Instance>>;
-declare namespace ParsedAstDeployment {
-  type Node = c4.DeploymentNode;
-  type Instance = Omit<c4.DeployedInstance, 'element'> & {
-    readonly element: c4.FqnRef.ModelRef;
-  };
+interface FileSystemWatcher extends AsyncDisposable {
+  /**
+   * Watches a folder for changes and triggers a reload of the documents and projects.
+   */
+  watch(folder: string): void;
 }
-type ParsedAstDeploymentRelation = c4.DeploymentRelationship & {
-  astPath: string;
+type ManualLayoutsSnapshot = {
+  hash: string;
+  views: Record<ViewId, LayoutedView>;
 };
-type ParsedAstGlobals = Writable<c4.ModelGlobals>;
-interface ParsedAstElementView {
-  id: c4.ViewId;
-  viewOf?: c4.Fqn;
-  extends?: c4.ViewId;
-  astPath: string;
-  title: string | null;
-  description: c4.MarkdownOrString | null;
-  tags: c4.NonEmptyArray<c4.Tag> | null;
-  links: c4.NonEmptyArray<c4.Link> | null;
-  rules: c4.ElementViewRule[];
-}
-interface ParsedAstDynamicView {
-  id: c4.ViewId;
-  astPath: string;
-  title: string | null;
-  description: c4.MarkdownOrString | null;
-  tags: c4.NonEmptyArray<c4.Tag> | null;
-  links: c4.NonEmptyArray<c4.Link> | null;
-  steps: c4.DynamicViewStep[];
-  rules: Array<c4.DynamicViewRule>;
-  variant: c4.DynamicViewDisplayVariant | undefined;
-}
-interface ParsedAstDeploymentView {
-  id: c4.ViewId;
-  astPath: string;
-  title: string | null;
-  description: c4.MarkdownOrString | null;
-  tags: c4.NonEmptyArray<c4.Tag> | null;
-  links: c4.NonEmptyArray<c4.Link> | null;
-  rules: Array<c4.DeploymentViewRule>;
-}
-type ParsedAstView = ParsedAstElementView | ParsedAstDynamicView | ParsedAstDeploymentView;
-interface AstNodeDescriptionWithFqn extends AstNodeDescription {
-  likec4ProjectId: c4.ProjectId;
-  id: c4.Fqn;
-}
-type LikeC4AstNode = ValueOf<ConditionalPick<LikeC4AstType, AstNode>>;
-type LikeC4DocumentDiagnostic = Diagnostic & DiagnosticInfo<LikeC4AstNode>;
-interface LikeC4DocumentProps {
-  diagnostics?: Array<LikeC4DocumentDiagnostic>;
-  c4Specification?: ParsedAstSpecification;
-  c4Elements?: ParsedAstElement[];
-  c4ExtendElements?: ParsedAstExtend[];
-  c4ExtendDeployments?: ParsedAstExtend[];
-  c4ExtendRelations?: ParsedAstExtendRelation[];
-  c4Relations?: ParsedAstRelation[];
-  c4Globals?: ParsedAstGlobals;
-  c4Views?: ParsedAstView[];
-  c4Deployments?: ParsedAstDeployment[];
-  c4DeploymentRelations?: ParsedAstDeploymentRelation[];
-  c4Imports?: MultiMap<c4.ProjectId, c4.Fqn, Set<c4.Fqn>>;
+type ManualLayoutUpdateEvent = {
+  updated: URI;
+  projectId: ProjectId;
+  viewId: ViewId;
+} | {
+  removed: URI;
+  projectId: ProjectId;
+  /**
+   * Missing if triggered by FS event (file was deleted)
+   */
+  viewId?: ViewId;
+};
+type ManualLayoutUpdateListener = (event: ManualLayoutUpdateEvent) => void;
+interface LikeC4ManualLayouts extends Disposable$1 {
+  /**
+   * Reads a single layouted view from the file system by its URI.
+   * Used by the language server to get the current layout state.
+   */
+  readSnapshot(uri: URI): Promise<LayoutedView | null>;
+  read(project: Project): Promise<ManualLayoutsSnapshot | null>;
+  write(project: Project, layouted: LayoutedView): Promise<Location>;
+  remove(project: Project, view: ViewId): Promise<Location | null>;
+  clearCaches(): void;
+  /**
+   * Registers a listener for manual layout updates.
+   * The listener will be called when a manual layout is created, updated, or deleted.
+   */
+  onManualLayoutUpdate(listener: ManualLayoutUpdateListener): Disposable$1;
+  /**
+   * Handles file system updates for manual layouts.
+   * Used by the file system watcher to notify the manual layouts module of changes.
+   * @param event The file system event
+   */
+  handleFileSystemUpdate(event: {
+    update: URI;
+    delete?: never;
+  } | {
+    delete: URI;
+    update?: never;
+  }): Promise<void>;
+} //#endregion
+//#region src/filesystem/noop.d.ts
+//#endregion
+//#region src/formatting/LikeC4Formatter.d.ts
+type QuoteStyle = 'single' | 'double' | 'ignore' | 'auto';
+interface LikeC4FormatterOptions {
+  quoteStyle: QuoteStyle;
 }
-type LikeC4GrammarDocument = Omit<LangiumDocument<LikeC4Grammar>, 'diagnostics'>;
-interface LikeC4LangiumDocument extends LikeC4GrammarDocument, LikeC4DocumentProps {
-  likec4ProjectId: c4.ProjectId;
+type ExtendedFormattingCommandType = 'normalizeQuotes';
+interface ExtendedFormattingCommand {
+  type: ExtendedFormattingCommandType;
+  region: FormattingRegion;
 }
-interface ParsedLikeC4LangiumDocument extends LikeC4GrammarDocument, Required<LikeC4DocumentProps> {
-  likec4ProjectId: c4.ProjectId;
+declare class LikeC4Formatter extends AbstractFormatter {
+  protected options: LikeC4FormatterOptions;
+  extendedFormattingCommands: ExtendedFormattingCommand[];
+  constructor(services: LikeC4Services);
+  protected doDocumentFormat(document: LangiumDocument, options: FormattingOptions, range?: Range): TextEdit[];
+  protected format(node: AstNode): void;
+  protected formatTags(node: AstNode): void;
+  protected formatDeploymentRelation(node: AstNode): void;
+  protected formatExtendDeployment(node: AstNode): void;
+  protected formatRelation(node: AstNode): void;
+  protected removeIndentFromTopLevelStatements(node: AstNode): void;
+  protected indentContentInBraces(node: AstNode): void;
+  protected appendKeywordsWithSpace(node: AstNode): void;
+  protected formatView(node: AstNode): void;
+  protected formatLeafProperty(node: AstNode): void;
+  protected formatLinkProperty(node: AstNode): void;
+  protected formatNavigateToProperty(node: AstNode): void;
+  protected formatAutolayoutProperty(node: AstNode): void;
+  protected formatMetadataProperty(node: AstNode): void;
+  protected formatElementDeclaration(node: AstNode): void;
+  protected formatExtendElement(node: AstNode): void;
+  protected formatGlobals(node: AstNode): void;
+  protected formatImports(node: AstNode): void;
+  protected formatSpecificationRule(node: AstNode): void;
+  protected formatWithPredicate(node: AstNode): void;
+  protected formatDeploymentNodeDeclaration(node: AstNode): void;
+  protected formatDeployedInstance(node: AstNode): void;
+  protected formatViewRuleGlobalStyle(node: AstNode): void;
+  protected formatViewRuleGlobalPredicate(node: AstNode): void;
+  protected formatViewRuleGroup(node: AstNode): void;
+  protected formatViewRuleStyle(node: AstNode): void;
+  protected formatWhereExpression(node: AstNode): void;
+  protected formatWhereRelationExpression(node: AstNode): void;
+  protected formatWhereElementExpression(node: AstNode): void;
+  protected formatIncludeExcludeExpressions(node: AstNode): void;
+  protected formatRelationExpression(node: AstNode): void;
+  private findPredicateExpressionRoot;
+  private on;
+  private doExtendedFormatting;
+  protected normalizeQuotes(node: AstNode): void;
+  private quotesNormalizerFactory;
+  private escapeQuotesInternalQuotes;
+  private getAutoQuoteStyle;
+  private onConfigurationUpdate;
 } //#endregion
 //#region src/references/name-provider.d.ts
 declare class LikeC4NameProvider extends DefaultNameProvider {
@@ -2362,14 +3511,6 @@ declare class LikeC4ScopeProvider extends DefaultScopeProvider {
    */
   protected getGlobalScope(referenceType: string, context: ReferenceInfo): Scope;
 } //#endregion
-//#region src/utils/disposable.d.ts
-declare abstract class ADisposable implements Disposable$1 {
-  protected toDispose: Disposable$1[];
-  protected isDisposed: boolean;
-  onDispose(...disposable: Disposable$1[]): void;
-  dispose(): void;
-  protected throwIfDisposed(): void;
-} //#endregion
 //#region src/model/fqn-index.d.ts
 declare class FqnIndex<AstNd = Element> extends ADisposable {
   protected services: LikeC4Services;
@@ -2503,7 +3644,7 @@ declare class MergedSpecification {
  * Provides access to "last seen artifacts" for a given project,
  * (Results of the last successful parsing)
  */
-declare class LastSeenArtifacts {
+declare class LastSeenArtifacts extends ADisposable {
   #private;
   constructor(services: LikeC4Services);
   /**
@@ -2638,7 +3779,7 @@ type LayoutViewParams = {
   cancelToken?: CancellationToken$1 | undefined; /** Optional AI-generated layout hints */
   layoutHints?: AILayoutHints | undefined;
 };
-interface LikeC4Views {
+interface LikeC4Views extends Disposable$1 {
   readonly layouter: GraphvizLayouter;
   /**
    * Returns computed views (i.e. views with predicates computed)
@@ -3417,7 +4558,7 @@ declare const DocumentParserFromMixins: {
   };
 } & typeof BaseParser;
 declare class DocumentParser extends DocumentParserFromMixins {}
-declare class LikeC4ModelParser {
+declare class LikeC4ModelParser extends ADisposable {
   private services;
   protected cachedParsers: any;
   constructor(services: LikeC4Services);
@@ -3767,15 +4908,15 @@ declare class LikeC4 {
   /**
    * File system path to the workspace root
    */
-  get workspace(): any;
+  get workspace(): string;
   /**
    * URI of the workspace root
    */
-  get workspaceURI(): any;
+  get workspaceURI(): URI;
   /**
    * URL of the workspace root
    */
-  get workspaceURL(): any;
+  get workspaceURL(): URL;
   get languageServices(): LikeC4LanguageServices;
   get projectsManager(): ProjectsManager;
   get viewsService(): LikeC4Views;
@@ -3834,9 +4975,11 @@ declare class LikeC4 {
    */
   documentCount(): number;
   /**
-   * @returns a function to dispose the listener
+   * Subscribe to model updates
+   * @param listener Function called when the model is updated - receives the project ID that was updated
+   * @returns A function to dispose the listener
    */
-  onModelUpdate(listener: () => void): () => void;
+  onModelUpdate(listener: (projectId: ProjectId) => void): () => void;
   /**
    * Formats documents and returns a map of document URI → formatted source text.
    *