likec4 1.55.1 → 1.57.0

package/dist/{_chunks → chunks}/index2.d.mts

@@ -1,16 +1,68 @@
+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.mjs";
-import { ElementModel, LikeC4Model } from "@likec4/core/model";
+import { t as $keywords } from "./libs/@ts-graphviz/common.mjs";
+import { LikeC4Styles } from "@likec4/core/styles";
+import { EdgeId, Fqn, GuardedBy, LayoutedView, NodeId, NonEmptyArray, NonEmptyReadonlyArray, ProjectId, ViewId } from "@likec4/core/types";
 import * as c4 from "@likec4/core";
-import { AnyAux, ComputedView, DeploymentFqn, DiagramView, EdgeId, Fqn, LayoutType, LayoutedView, LikeC4Styles, NonEmptyArray, NonEmptyReadonlyArray, ProjectId, RelationId, Tag, UnknownComputed, UnknownLayouted, UnknownParsed, ViewChange, ViewId, aux } from "@likec4/core";
-import { LikeC4Styles as LikeC4Styles$1 } from "@likec4/core/styles";
-import { Fqn as Fqn$1, GuardedBy, LayoutedView as LayoutedView$1, ProjectId as ProjectId$1, ViewId as ViewId$1 } from "@likec4/core/types";
+import { AnyAux, ComputedView, DeploymentFqn, DiagramView, EdgeId as EdgeId$1, Fqn as Fqn$1, LayoutType, LayoutedView as LayoutedView$1, LikeC4Styles as LikeC4Styles$1, NonEmptyArray as NonEmptyArray$1, NonEmptyReadonlyArray as NonEmptyReadonlyArray$1, ProjectId as ProjectId$1, RelationId, Tag, UnknownComputed, UnknownLayouted, UnknownParsed, ViewChange, ViewId as ViewId$1, aux as aux$1 } from "@likec4/core";
 import { DefaultWeakMap, MultiMap } from "@likec4/core/utils";
+import { ElementModel, LikeC4Model } from "@likec4/core/model";
 import { AdhocViewPredicate, ComputedProjectsView, LayoutedProjectsView } from "@likec4/core/compute-view";
 import * as type_fest0 from "type-fest";
 import { ConditionalPick, MergeExclusive, Simplify, Tagged, ValueOf, Writable } from "type-fest";
 
+//#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
@@ -19,8 +71,8 @@ import { ConditionalPick, MergeExclusive, Simplify, Tagged, ValueOf, Writable }
  */
 declare namespace DidRequestOpenViewNotification {
   type Params = {
-    viewId: ViewId;
-    projectId: ProjectId;
+    viewId: ViewId$1;
+    projectId: ProjectId$1;
   };
   const type: NotificationType<Params>;
   type Type = typeof type;
@@ -40,7 +92,7 @@ declare namespace Locate {
    * Locate an element by its fqn
    */
   {
-    element: Fqn;
+    element: Fqn$1;
     projectId?: string | undefined;
     property?: string;
   }
@@ -63,7 +115,7 @@ declare namespace Locate {
    * Locate a step in a dynamic view by its astPath
    */
   | {
-    view: ViewId;
+    view: ViewId$1;
     astPath: string;
     projectId?: string | undefined;
   }
@@ -71,7 +123,7 @@ declare namespace Locate {
    * Locate a view by its id
    */
   | {
-    view: ViewId;
+    view: ViewId$1;
     projectId?: string | undefined;
   };
   type Res = Location | null;
@@ -84,7 +136,7 @@ declare namespace Locate {
  */
 declare namespace ChangeView {
   type Params = {
-    viewId: ViewId;
+    viewId: ViewId$1;
     change: ViewChange;
     projectId?: string | undefined;
   };
@@ -223,7 +275,7 @@ declare namespace GraphvizJson {
     _ldraw_?: LabelDrawOps[];
     likec4_type?: 'folder' | 'file';
     likec4_path?: string;
-    likec4_id?: Fqn;
+    likec4_id?: Fqn$1;
     likec4_level?: number;
     likec4_depth?: number;
     _gvid: GvId;
@@ -236,7 +288,7 @@ declare namespace GraphvizJson {
     _ldraw_?: LabelDrawOps[];
     likec4_type?: 'folder' | 'file' | 'view';
     likec4_path?: string;
-    likec4_id?: Fqn;
+    likec4_id?: Fqn$1;
     likec4_level?: number;
     _gvid: GvId;
     height: string;
@@ -271,7 +323,7 @@ declare namespace GraphvizJson {
     _hldraw_?: LabelDrawOps[];
     fontname: string;
     fontsize: string;
-    likec4_id?: EdgeId;
+    likec4_id?: EdgeId$1;
     label: string;
     lp: string;
     nojustify?: 'true' | 'false';
@@ -288,11 +340,11 @@ interface GraphvizPort extends Disposable {
   svg(dot: DotSource): Promise<string>;
   dispose(): void;
 }
-type LayoutTaskParams<A extends aux.Any = aux.Any> = {
+type LayoutTaskParams<A extends aux$1.Any = aux$1.Any> = {
   view: ComputedView<A>;
-  styles: LikeC4Styles;
+  styles: LikeC4Styles$1;
 };
-type LayoutResult<A extends aux.Any = aux.Any> = {
+type LayoutResult<A extends aux$1.Any = aux$1.Any> = {
   dot: DotSource;
   diagram: DiagramView<A>;
 };
@@ -303,9 +355,19 @@ declare class GraphvizLayouter implements Disposable {
   [Symbol.dispose](): void;
   get graphvizPort(): GraphvizPort;
   changePort(graphviz: GraphvizPort): void;
-  printToDot(params: LayoutTaskParams): DotSource;
+  /**
+   * 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;
@@ -379,6 +441,7 @@ declare class LikeC4DocumentationProvider extends JSDocDocumentationProvider {
   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).
@@ -387,12 +450,12 @@ type DocOrUri = LangiumDocument | string | URI;
 type ProjectFolder = Tagged<string, 'ProjectFolder'>;
 declare function ProjectFolder(folder: URI | string): ProjectFolder;
 interface Project {
-  id: ProjectId$1;
+  id: ProjectId;
   folderUri: URI;
   config: LikeC4ProjectConfig;
 }
 interface ProjectData extends Project {
-  id: ProjectId$1;
+  id: ProjectId;
   folder: ProjectFolder;
   config: LikeC4ProjectConfig;
   configUri: URI;
@@ -404,7 +467,7 @@ interface ProjectData extends Project {
    * Resolved include paths with both URI and folder string representations.
    * These are additional directories that are part of this project.
    */
-  includePaths?: NonEmptyArray<{
+  includePaths?: NonEmptyArray$1<{
     uri: URI;
     folder: ProjectFolder;
   }>;
@@ -427,8 +490,13 @@ declare class ProjectsManager {
    * The global project ID used for all documents
    * that are not part of a specific project.
    */
-  static readonly DefaultProjectId: ProjectId$1;
+  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.
@@ -441,37 +509,45 @@ declare class ProjectsManager {
    *  - the ID of the only project
    *  - undefined if there are multiple projects.
    */
-  get defaultProjectId(): ProjectId$1 | undefined;
-  set defaultProjectId(id: string | ProjectId$1 | undefined);
+  get defaultProjectId(): ProjectId | undefined;
+  set defaultProjectId(id: string | ProjectId | undefined);
   get default(): ProjectData;
-  get all(): NonEmptyReadonlyArray<ProjectId$1>;
-  getProject(arg: ProjectId$1 | LangiumDocument): 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): ProjectData[];
+  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$1 | undefined): ProjectId$1;
+  ensureProjectId(projectId?: ProjectId | undefined): ProjectId;
   /**
-   * Validates and ensures the project.
+   * 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$1 | undefined): ProjectData;
+  ensureProject(projectId?: ProjectId | undefined): ProjectData;
   hasMultipleProjects(): boolean;
   /**
-   * Checks if the specified document should be excluded from processing.
+   * Checks if given document (or URI) must be excluded from processing.
    */
   isExcluded(document: DocOrUri): boolean;
-  isExcluded(projectId: ProjectId$1, 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$1, document: LangiumDocument | URI | string): boolean;
+  isIncluded(projectId: ProjectId, document: LangiumDocument | URI | string): boolean;
   /**
    * Registers likec4 project by config file.
    */
@@ -485,18 +561,28 @@ declare class ProjectsManager {
    * 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$1;
+  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$1;
+  protected uniqueProjectId(name: string): ProjectId;
   protected resetCaches(): void;
-  rebuildProject(projectId: ProjectId$1, cancelToken?: CancellationToken$1): Promise<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$1;
+    projectId: ProjectId;
     includePath: URI;
     includeConfig: IncludeConfig;
   }>;
@@ -528,7 +614,8 @@ interface FileSystemProvider$1 extends FileSystemProvider {
    */
   loadProjectConfig(filepath: URI): Promise<LikeC4ProjectConfig>;
   /**
-   * Reads the directory information for the given URI.
+   * 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)
    */
@@ -539,7 +626,7 @@ interface FileSystemProvider$1 extends FileSystemProvider {
   /**
    * Finds all files in the given directory, matching the given filter.
    */
-  scanDirectory(directory: URI, filter: (filepath: string) => boolean): Promise<FileNode[]>;
+  scanDirectory(directory: URI, filter: (filepath: string, isDirectory: boolean) => boolean): Promise<FileNode[]>;
   /**
    * Writes the content to the file system.
    * Used by manual layouts.
@@ -560,19 +647,19 @@ interface FileSystemWatcher extends AsyncDisposable {
 }
 type ManualLayoutsSnapshot = {
   hash: string;
-  views: Record<ViewId$1, LayoutedView$1>;
+  views: Record<ViewId, LayoutedView>;
 };
 type ManualLayoutUpdateEvent = {
   updated: URI;
-  projectId: ProjectId$1;
-  viewId: ViewId$1;
+  projectId: ProjectId;
+  viewId: ViewId;
 } | {
   removed: URI;
-  projectId: ProjectId$1;
+  projectId: ProjectId;
   /**
    * Missing if triggered by FS event (file was deleted)
    */
-  viewId?: ViewId$1;
+  viewId?: ViewId;
 };
 type ManualLayoutUpdateListener = (event: ManualLayoutUpdateEvent) => void;
 interface LikeC4ManualLayouts {
@@ -580,10 +667,10 @@ interface LikeC4ManualLayouts {
    * 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$1 | null>;
+  readSnapshot(uri: URI): Promise<LayoutedView | null>;
   read(project: Project): Promise<ManualLayoutsSnapshot | null>;
-  write(project: Project, layouted: LayoutedView$1): Promise<Location>;
-  remove(project: Project, view: ViewId$1): Promise<Location | 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.
@@ -672,7 +759,7 @@ type DeploymentElement = DeployedInstance | DeploymentNode;
 declare const DeploymentElement = "DeploymentElement";
 type DeploymentNodeOrElementKind = DeploymentNodeKind | ElementKind;
 declare const DeploymentNodeOrElementKind = "DeploymentNodeOrElementKind";
-type DeploymentViewRule = DeploymentViewRulePredicate | DeploymentViewRuleStyle | ViewRuleAutoLayout;
+type DeploymentViewRule = DeploymentViewRulePredicate | DeploymentViewRuleStyle | ViewRuleAncestors | ViewRuleAutoLayout;
 declare const DeploymentViewRule = "DeploymentViewRule";
 type DynamicViewDisplayVariantValue = 'diagram' | 'sequence';
 type DynamicViewProperty = DynamicViewDisplayVariantProperty | ViewProperty;
@@ -804,7 +891,7 @@ declare const CustomElementProperties = "CustomElementProperties";
 interface CustomRelationProperties extends AstNode {
   readonly $container: AbstractDynamicStep | RelationExprWith;
   readonly $type: 'CustomRelationProperties';
-  props: Array<NotationProperty | NotesProperty | RelationNavigateToProperty | RelationStringProperty | RelationshipStyleProperty>;
+  props: Array<MultipleProperty | NotationProperty | NotesProperty | RelationNavigateToProperty | RelationStringProperty | RelationshipStyleProperty>;
 }
 declare const CustomRelationProperties = "CustomRelationProperties";
 interface DeployedInstance extends AstNode {
@@ -1283,7 +1370,7 @@ interface MetadataAttribute extends AstNode {
   readonly $container: MetadataBody;
   readonly $type: 'MetadataAttribute';
   boolValue: boolean;
-  key: string;
+  key: Id;
   value?: MetadataValue;
 }
 declare const MetadataAttribute = "MetadataAttribute";
@@ -1317,7 +1404,7 @@ interface ModelViews extends AstNode {
 }
 declare const ModelViews = "ModelViews";
 interface MultipleProperty extends AstNode {
-  readonly $container: CustomElementProperties | DeploymentViewRuleStyle | ElementStyleProperty | GlobalStyle | ViewRuleStyle;
+  readonly $container: CustomElementProperties | CustomRelationProperties | DeploymentViewRuleStyle | ElementStyleProperty | GlobalStyle | SpecificationRelationshipKind | ViewRuleStyle;
   readonly $type: 'MultipleProperty';
   key: 'multiple';
   value: boolean;
@@ -1492,7 +1579,7 @@ interface SpecificationRelationshipKind extends AstNode {
   readonly $container: SpecificationRule;
   readonly $type: 'SpecificationRelationshipKind';
   kind: RelationshipKind;
-  props: Array<RelationshipStyleProperty | SpecificationRelationshipStringProperty>;
+  props: Array<MultipleProperty | RelationshipStyleProperty | SpecificationRelationshipStringProperty>;
 }
 declare const SpecificationRelationshipKind = "SpecificationRelationshipKind";
 interface SpecificationRelationshipStringProperty extends AstNode {
@@ -1566,6 +1653,13 @@ interface ViewRef extends AstNode {
   view: Reference<LikeC4View>;
 }
 declare const ViewRef = "ViewRef";
+interface ViewRuleAncestors extends AstNode {
+  readonly $container: DeploymentViewBody;
+  readonly $type: 'ViewRuleAncestors';
+  key: 'includeAncestors';
+  value: boolean;
+}
+declare const ViewRuleAncestors = "ViewRuleAncestors";
 interface ViewRuleAutoLayout extends AstNode {
   readonly $container: DeploymentViewBody | DynamicViewBody | ElementViewBody;
   readonly $type: 'ViewRuleAutoLayout';
@@ -1883,6 +1977,7 @@ type LikeC4AstType = {
   ViewProperty: ViewProperty;
   ViewRef: ViewRef;
   ViewRule: ViewRule;
+  ViewRuleAncestors: ViewRuleAncestors;
   ViewRuleAutoLayout: ViewRuleAutoLayout;
   ViewRuleGlobalPredicateRef: ViewRuleGlobalPredicateRef;
   ViewRuleGlobalStyle: ViewRuleGlobalStyle;
@@ -1989,6 +2084,7 @@ interface ParsedAstSpecification {
     line?: c4.RelationshipLineType;
     head?: c4.RelationshipArrowType;
     tail?: c4.RelationshipArrowType;
+    multiple?: boolean;
   }>;
   colors: Record<c4.CustomColor, {
     color: c4.ColorLiteral;
@@ -2147,7 +2243,7 @@ declare class IndexManager extends DefaultIndexManager {
   protected services: LikeC4SharedServices;
   constructor(services: LikeC4SharedServices);
   updateContent(document: LangiumDocument, cancelToken?: CancellationToken$1): Promise<void>;
-  projectElements(projectId: ProjectId, nodeType?: string, uris?: Set<string>): Stream<AstNodeDescription>;
+  projectElements(projectId: ProjectId$1, nodeType?: string, uris?: Set<string>): Stream<AstNodeDescription>;
 } //#endregion
 //#region src/workspace/LangiumDocuments.d.ts
 declare class LangiumDocuments extends DefaultLangiumDocuments {
@@ -2167,8 +2263,8 @@ declare class LangiumDocuments extends DefaultLangiumDocuments {
   /**
    * Returns all documents for a project, including both project documents and documents included by the project.
    */
-  projectDocuments(projectId: ProjectId): Stream<LikeC4LangiumDocument>;
-  groupedByProject(): Record<ProjectId, NonEmptyArray<LikeC4LangiumDocument>>;
+  projectDocuments(projectId: ProjectId$1): Stream<LikeC4LangiumDocument>;
+  groupedByProject(): Record<ProjectId$1, NonEmptyArray$1<LikeC4LangiumDocument>>;
   /**
    * Reset the project IDs of all documents.
    * Returns the URIs
@@ -2184,20 +2280,24 @@ declare class LikeC4WorkspaceManager extends DefaultWorkspaceManager {
   initialBuildOptions: BuildOptions;
   constructor(services: LikeC4SharedServices);
   /**
-   * First load all project config files, then load all documents in the workspace.
+   * Whether the workspace is ready, use {@link ready} promise to wait for it
    */
-  protected performStartup(folders: WorkspaceFolder[]): Promise<LangiumDocument[]>;
+  get isReady(): boolean;
   /**
-   * Read workspace exclude patterns from configuration before workspace scan.
-   * Uses a timeout fallback for third-party IDEs that may not support workspace/configuration.
+   * First load all project config files, then load all documents in the workspace.
    */
-  private readExcludeConfig;
+  protected performStartup(folders: WorkspaceFolder[]): Promise<LangiumDocument[]>;
   /**
    * Load all additional documents that shall be visible in the context of the given workspace
    * folders and add them to the collector. This can be used to include built-in libraries of
    * your language, which can be either loaded from provided files or constructed in memory.
    */
   protected loadAdditionalDocuments(folders: WorkspaceFolder[], collector: (document: LangiumDocument) => void): Promise<void>;
+  /**
+   * Traverse the file system folder identified by the given URI and its subfolders. All
+   * contained files that match the file extensions are added to the collector.
+   */
+  protected traverseFolder(workspaceFolder: WorkspaceFolder, folderPath: URI, selector: FileSelector, collector: (document: LangiumDocument) => void): Promise<void>;
   /**
    * Determine whether the given folder entry shall be included while indexing the workspace.
    */
@@ -2214,6 +2314,11 @@ declare class LikeC4WorkspaceManager extends DefaultWorkspaceManager {
    * Register a listener to be called when caches are force cleaned
    */
   onForceCleanCache(listener: () => void): Disposable$1;
+  /**
+   * Read workspace exclude patterns from configuration before workspace scan.
+   * Uses a timeout fallback for third-party IDEs that may not support workspace/configuration.
+   */
+  private readExcludeConfig;
 } //#endregion
 //#region src/references/scope-provider.d.ts
 declare class LikeC4ScopeProvider extends DefaultScopeProvider {
@@ -2230,12 +2335,12 @@ declare class LikeC4ScopeProvider extends DefaultScopeProvider {
     viewOf,
     extends: ext
   }: ElementView): Generator<AstNodeDescription>;
-  protected getScopeForStrictFqnRef(projectId: ProjectId, container: StrictFqnRef, context: ReferenceInfo): Scope;
+  protected getScopeForStrictFqnRef(projectId: ProjectId$1, container: StrictFqnRef, context: ReferenceInfo): Scope;
   protected genScopeExtendDeployment({
     deploymentNode
   }: ExtendDeployment): Generator<AstNodeDescription>;
-  protected streamForFqnRef(projectId: ProjectId, container: FqnRef$2, context: ReferenceInfo): Stream<AstNodeDescription>;
-  protected genScopeForParentlessFqnRef(projectId: ProjectId, container: FqnRef$2, context: ReferenceInfo): Generator<AstNodeDescription>;
+  protected streamForFqnRef(projectId: ProjectId$1, container: FqnRef$2, context: ReferenceInfo): Stream<AstNodeDescription>;
+  protected genScopeForParentlessFqnRef(projectId: ProjectId$1, container: FqnRef$2, context: ReferenceInfo): Generator<AstNodeDescription>;
   /**
    * Computes the scope for a given reference context.
    *
@@ -2247,11 +2352,11 @@ declare class LikeC4ScopeProvider extends DefaultScopeProvider {
    * It then iterates through the container hierarchy, collecting relevant scopes based on the reference type and container type.
    * Finally, it combines the collected scopes with the global scope to produce the final scope.
    */
-  protected computeScope(projectId: ProjectId, context: ReferenceInfo, referenceType?: string): Generator<AstNodeDescription>;
+  protected computeScope(projectId: ProjectId$1, context: ReferenceInfo, referenceType?: string): Generator<AstNodeDescription>;
   /**
    * Create a global scope filtered for the given reference type.
    */
-  protected getProjectScope(projectId: ProjectId, referenceType: string, context: ReferenceInfo): Scope;
+  protected getProjectScope(projectId: ProjectId$1, referenceType: string, context: ReferenceInfo): Scope;
   /**
    * Create a global scope filtered for the given reference type.
    */
@@ -2276,15 +2381,15 @@ declare class FqnIndex<AstNd = Element> extends ADisposable {
   constructor(services: LikeC4Services);
   private documents;
   get(document: LikeC4LangiumDocument): DocumentFqnIndex;
-  resolve(reference: Referenceable): Fqn$1;
-  getFqn(el: AstNd): Fqn$1;
-  byFqn(projectId: ProjectId$1, fqn: Fqn$1): Stream<AstNodeDescriptionWithFqn>;
-  rootElements(projectId: ProjectId$1): Stream<AstNodeDescriptionWithFqn>;
-  directChildrenOf(projectId: ProjectId$1, parent: Fqn$1): Stream<AstNodeDescriptionWithFqn>;
+  resolve(reference: Referenceable): Fqn;
+  getFqn(el: AstNd): Fqn;
+  byFqn(projectId: ProjectId, fqn: Fqn): Stream<AstNodeDescriptionWithFqn>;
+  rootElements(projectId: ProjectId): Stream<AstNodeDescriptionWithFqn>;
+  directChildrenOf(projectId: ProjectId, parent: Fqn): Stream<AstNodeDescriptionWithFqn>;
   /**
    * Returns descedant elements with unique names in the scope
    */
-  uniqueDescedants(projectId: ProjectId$1, parent: Fqn$1): Stream<AstNodeDescriptionWithFqn>;
+  uniqueDescedants(projectId: ProjectId, parent: Fqn): Stream<AstNodeDescriptionWithFqn>;
   protected createDocumentIndex(document: LikeC4LangiumDocument): DocumentFqnIndex;
 }
 declare class DocumentFqnIndex {
@@ -2301,28 +2406,28 @@ declare class DocumentFqnIndex {
    * All elements by FQN
    */
   private _byfqn;
-  readonly projectId: ProjectId$1;
+  readonly projectId: ProjectId;
   static readonly EMPTY: DocumentFqnIndex;
   constructor(_rootElements: Array<AstNodeDescriptionWithFqn>,
   /**
    * direct children of elements
    */
 
-  _children: MultiMap<Fqn$1, AstNodeDescriptionWithFqn>,
+  _children: MultiMap<Fqn, AstNodeDescriptionWithFqn>,
   /**
    * All descendants of an element (unique by name)
    */
 
-  _descendants: MultiMap<Fqn$1, AstNodeDescriptionWithFqn>,
+  _descendants: MultiMap<Fqn, AstNodeDescriptionWithFqn>,
   /**
    * All elements by FQN
    */
 
-  _byfqn: MultiMap<Fqn$1, AstNodeDescriptionWithFqn>, projectId: ProjectId$1);
+  _byfqn: MultiMap<Fqn, AstNodeDescriptionWithFqn>, projectId: ProjectId);
   rootElements(): readonly AstNodeDescriptionWithFqn[];
-  byFqn(fqn: Fqn$1): readonly AstNodeDescriptionWithFqn[];
-  children(parent: Fqn$1): readonly AstNodeDescriptionWithFqn[];
-  descendants(nodeName: Fqn$1): readonly AstNodeDescriptionWithFqn[];
+  byFqn(fqn: Fqn): readonly AstNodeDescriptionWithFqn[];
+  children(parent: Fqn): readonly AstNodeDescriptionWithFqn[];
+  descendants(nodeName: Fqn): readonly AstNodeDescriptionWithFqn[];
 } //#endregion
 //#region src/model/deployments-index.d.ts
 declare class DeploymentsIndex extends FqnIndex<DeploymentElement> {
@@ -2424,7 +2529,7 @@ declare class LastSeenArtifacts {
    * @param projectId - Project id to look up.
    * @returns LikeC4Styles or undefined.
    */
-  styles(projectId: c4.ProjectId): LikeC4Styles$1 | undefined;
+  styles(projectId: c4.ProjectId): LikeC4Styles | undefined;
   /**
    * Returns the last seen computed model for the given project, if available.
    * @param projectId - Project id to look up.
@@ -2433,11 +2538,11 @@ declare class LastSeenArtifacts {
   model(projectId: c4.ProjectId): LikeC4Model.Computed | undefined;
 } //#endregion
 //#region src/model/model-builder.d.ts
-type ModelParsedListener = (projectId: ProjectId, docs: URI[]) => void;
+type ModelParsedListener = (projectId: ProjectId$1, docs: URI[]) => void;
 interface LikeC4ModelBuilder extends Disposable$1 {
-  parseModel(projectId?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownParsed> | null>;
-  unsafeSyncComputeModel(projectId: ProjectId): LikeC4Model<UnknownComputed>;
-  computeModel(projectId?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownComputed>>;
+  parseModel(projectId?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownParsed> | null>;
+  unsafeSyncComputeModel(projectId: ProjectId$1): LikeC4Model<UnknownComputed>;
+  computeModel(projectId?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownComputed>>;
   onModelParsed(callback: ModelParsedListener): Disposable$1;
   clearCache(): void;
 } //#endregion
@@ -2513,15 +2618,15 @@ declare class LikeC4ModelLocator {
 //#region src/views/LikeC4Views.d.ts
 type GraphvizOut = {
   readonly dot: string;
-  readonly diagram: LayoutedView;
+  readonly diagram: LayoutedView$1;
 };
 type GraphvizSvgOut = {
-  readonly id: ViewId;
+  readonly id: ViewId$1;
   readonly dot: string;
   readonly svg: string;
 };
 type LayoutViewParams = {
-  viewId: ViewId;
+  viewId: ViewId$1;
   /**
    * Type of layout to apply
    * - 'manual' - applies manual layout if any
@@ -2529,8 +2634,9 @@ type LayoutViewParams = {
    * - undefined - returns latest layout as is
    */
   layoutType?: LayoutType | undefined;
-  projectId?: ProjectId | undefined;
-  cancelToken?: CancellationToken$1 | undefined;
+  projectId?: ProjectId$1 | undefined;
+  cancelToken?: CancellationToken$1 | undefined; /** Optional AI-generated layout hints */
+  layoutHints?: AILayoutHints | undefined;
 };
 interface LikeC4Views {
   readonly layouter: GraphvizLayouter;
@@ -2539,19 +2645,21 @@ interface LikeC4Views {
    *
    * @param projectId - project id, if not specified - uses the default project
    */
-  computedViews(projectId?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<ComputedView[]>;
+  computedViews(projectId?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<ComputedView[]>;
   /**
    * Layouts all views (ignoring any manual snapshots)
    *
    * @param projectId - project id, if not specified - uses the default project
    */
-  layoutAllViews(projectId?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<GraphvizOut[]>;
+  layoutAllViews(projectId?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<GraphvizOut[]>;
   /**
    * Layouts a view.
-   * If layoutType is 'manual' - applies manual layout if any.
-   * If layoutType is 'auto' - returns latest version with drifts from manual layout if any
+   * If `layoutType` is 'manual' - applies manual layout if any.
+   * If `layoutType` is 'auto' - returns latest version with drifts from manual layout if any
    * If not specified - returns latest layout as is
    *
+   * If `layoutHints` are provided, they will be used, ignoring any manual snapshots, and the resulting layout will not be cached (i.e. it will be computed on every call)
+   *
    * If view not found in model, but there is a snapshot - it will be returned (with empty DOT)
    */
   layoutView(params: LayoutViewParams): Promise<GraphvizOut | null>;
@@ -2560,25 +2668,25 @@ interface LikeC4Views {
    * If diagram has manual layout, it will be used.
    * @param projectId - project id, if not specified - uses the default project
    */
-  diagrams(projectId?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<Array<DiagramView>>;
+  diagrams(projectId?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<Array<DiagramView>>;
   /**
    * Returns all layouted views as Graphviz output (i.e. views with layout computed)
    * @param projectId - project id, if not specified - uses the default project
    */
-  viewsAsGraphvizOut(projectId?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<Array<GraphvizSvgOut>>;
+  viewsAsGraphvizOut(projectId?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<Array<GraphvizSvgOut>>;
   /**
    * Open view in the preview panel.
    * (works only if running as a vscode extension)
    *
    * @param projectId - project id, if not specified - uses the default project
    */
-  openView(viewId: ViewId, projectId?: ProjectId | undefined): Promise<void>;
+  openView(viewId: ViewId$1, projectId?: ProjectId$1 | undefined): Promise<void>;
   /**
    * Computes and layouts an adhoc view (not defined in the model)
    *
    * @param projectId - project id, if not specified - uses the default project
    */
-  adhocView(predicates: AdhocViewPredicate[], projectId?: ProjectId | undefined): Promise<LayoutedView>;
+  adhocView(predicates: AdhocViewPredicate[], projectId?: ProjectId$1 | undefined): Promise<LayoutedView$1>;
 } //#endregion
 //#region src/views/index.d.ts
 //#endregion
@@ -2589,6 +2697,10 @@ declare class BaseParser {
   readonly doc: ParsedLikeC4LangiumDocument;
   readonly project: Project;
   isValid: IsValidFn;
+  /** Full URI of the document */
+  docUri: string;
+  /** Path of the document relative to the project root */
+  docPathInProject: string;
   constructor(services: LikeC4Services, doc: ParsedLikeC4LangiumDocument, project: Project);
   logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: ParserLevel): void;
   tryParse<N extends AstNode, T>(level: ParserLevel, node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
@@ -2640,82 +2752,84 @@ declare class BaseParser {
 declare const DocumentParserFromMixins: {
   new (...args: any[]): {
     parseGlobals(): void;
-    parseAndStoreGlobalPredicateGroupOrDynamic(astRule: GlobalPredicateGroup | GlobalDynamicPredicateGroup, id: ProjectId, c4Globals: ParsedAstGlobals): void;
-    parseGlobalPredicateGroup(astRule: GlobalPredicateGroup): ProjectId[];
-    parseGlobalDynamicPredicateGroup(astRule: GlobalDynamicPredicateGroup): ProjectId[];
-    parseGlobalStyleOrGroup(astRule: GlobalStyle | GlobalStyleGroup): ProjectId[];
+    parseAndStoreGlobalPredicateGroupOrDynamic(astRule: GlobalPredicateGroup | GlobalDynamicPredicateGroup, id: ProjectId$1, c4Globals: ParsedAstGlobals): void;
+    parseGlobalPredicateGroup(astRule: GlobalPredicateGroup): ProjectId$1[];
+    parseGlobalDynamicPredicateGroup(astRule: GlobalDynamicPredicateGroup): ProjectId$1[];
+    parseGlobalStyleOrGroup(astRule: GlobalStyle | GlobalStyleGroup): ProjectId$1[];
     parseViews(): void;
     parseElementView(astNode: ElementView, additionalStyles: any[]): ParsedAstElementView;
-    parseElementViewRule(astRule: ViewRule): ProjectId;
-    parseViewRulePredicate(astNode: ViewRulePredicate): ProjectId;
-    parseViewRuleGlobalPredicateRef(astRule: ViewRuleGlobalPredicateRef | DynamicViewGlobalPredicateRef): ProjectId;
+    parseElementViewRule(astRule: ViewRule): ProjectId$1;
+    parseViewRulePredicate(astNode: ViewRulePredicate): ProjectId$1;
+    parseViewRuleGlobalPredicateRef(astRule: ViewRuleGlobalPredicateRef | DynamicViewGlobalPredicateRef): ProjectId$1;
     parseViewRuleStyleOrGlobalRef(astRule: ViewRuleStyleOrGlobalRef): any;
-    parseViewRuleGroup(astNode: ViewRuleGroup): ProjectId;
-    parseViewRuleRank(astRule: ViewRuleRank): ProjectId;
-    parseViewRuleStyle(astRule: ViewRuleStyle | GlobalStyle): ProjectId;
-    parseViewRuleGlobalStyle(astRule: ViewRuleGlobalStyle): ProjectId;
+    parseViewRuleGroup(astNode: ViewRuleGroup): ProjectId$1;
+    parseViewRuleRank(astRule: ViewRuleRank): ProjectId$1;
+    parseViewRuleStyle(astRule: ViewRuleStyle | GlobalStyle): ProjectId$1;
+    parseViewRuleGlobalStyle(astRule: ViewRuleGlobalStyle): ProjectId$1;
     parseDynamicElementView(astNode: DynamicView, additionalStyles: any[]): ParsedAstDynamicView;
-    parseDynamicViewRule(astRule: DynamicViewRule): ProjectId;
-    parseDynamicViewIncludePredicate(astRule: DynamicViewIncludePredicate): ProjectId;
-    parseDynamicParallelSteps(node: DynamicViewParallelSteps): ProjectId;
-    parseDynamicStep(node: DynamicViewStep): ProjectId | ProjectId;
-    recursiveParseDynamicStepChain(node: DynamicStepChain, callstack?: Array<[source: ProjectId, target: ProjectId]>): ProjectId[];
-    parseDynamicStepSingle(node: DynamicStepSingle): ProjectId;
-    parseAbstractDynamicStep(astnode: AbstractDynamicStep): type_fest0.Writable<type_fest0.Except<ProjectId, "source", {
+    parseDynamicViewRule(astRule: DynamicViewRule): ProjectId$1;
+    parseDynamicViewIncludePredicate(astRule: DynamicViewIncludePredicate): ProjectId$1;
+    parseDynamicParallelSteps(node: DynamicViewParallelSteps): ProjectId$1;
+    parseDynamicStep(node: DynamicViewStep): ProjectId$1 | ProjectId$1;
+    recursiveParseDynamicStepChain(node: DynamicStepChain, callstack?: Array<[source: ProjectId$1, target: ProjectId$1]>): ProjectId$1[];
+    parseDynamicStepSingle(node: DynamicStepSingle): ProjectId$1;
+    parseAbstractDynamicStep(astnode: AbstractDynamicStep): type_fest0.Writable<type_fest0.Except<ProjectId$1, "source", {
       requireExactProps: true;
     }>>;
-    parsePredicate(astNode: ExpressionV2): ProjectId;
-    parseElementPredicate(astNode: FqnExprOrWith): ProjectId;
-    parseElementPredicateOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseElementExpression(astNode: FqnExpr$2): ProjectId;
-    parseElementPredicateWhere(astNode: FqnExprWhere): ProjectId;
-    parseElementPredicateWith(astNode: FqnExprWith): ProjectId;
-    parseRelationPredicate(astNode: RelationExprOrWith): ProjectId;
-    parseRelationPredicateOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationPredicateWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationPredicateWith(astNode: RelationExprWith): ProjectId;
-    parseRelationExpression(astNode: RelationExpr$1): ProjectId;
-    parseFqnRef(astNode: FqnRef$2): ProjectId;
-    parseExpressionV2(astNode: ExpressionV2): ProjectId;
-    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId;
-    parseFqnExprWith(astNode: FqnExprWith): ProjectId;
-    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId;
-    parseFqnExpr(astNode: FqnExpr$2): ProjectId;
-    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId;
-    parseFqnExpressions(astNode: FqnExpressions): ProjectId[];
-    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId;
-    parseRelationExprWith(astNode: RelationExprWith): ProjectId;
-    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId["customRelation"], "expr">;
-    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationExpr(astNode: RelationExpr$1): ProjectId;
-    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId | null;
-    wrapInWhere(expr: ProjectId, condition: ProjectId | null): ProjectId;
+    parsePredicate(astNode: ExpressionV2): ProjectId$1;
+    parseElementPredicate(astNode: FqnExprOrWith): ProjectId$1;
+    parseElementPredicateOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseElementExpression(astNode: FqnExpr$2): ProjectId$1;
+    parseElementPredicateWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseElementPredicateWith(astNode: FqnExprWith): ProjectId$1;
+    parseRelationPredicate(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationPredicateOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationPredicateWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationPredicateWith(astNode: RelationExprWith): ProjectId$1;
+    parseRelationExpression(astNode: RelationExpr$1): ProjectId$1;
+    parseFqnRef(astNode: FqnRef$2): ProjectId$1;
+    parseExpressionV2(astNode: ExpressionV2): ProjectId$1;
+    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId$1;
+    parseFqnExprWith(astNode: FqnExprWith): ProjectId$1;
+    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseFqnExpr(astNode: FqnExpr$2): ProjectId$1;
+    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId$1;
+    parseFqnExpressions(astNode: FqnExpressions): ProjectId$1[];
+    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationExprWith(astNode: RelationExprWith): ProjectId$1;
+    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId$1["customRelation"], "expr">;
+    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationExpr(astNode: RelationExpr$1): ProjectId$1;
+    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId$1 | null;
+    wrapInWhere(expr: ProjectId$1, condition: ProjectId$1 | null): ProjectId$1;
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -2730,95 +2844,97 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
     parseDeploymentView(astNode: DeploymentView): ParsedAstDeploymentView;
-    parseDeploymentViewRule(astRule: DeploymentViewRule): ProjectId;
-    parseDeploymentViewRulePredicate(astRule: DeploymentViewRulePredicate): ProjectId;
-    parseDeploymentViewRuleStyle(astRule: DeploymentViewRuleStyle): ProjectId;
+    parseDeploymentViewRule(astRule: DeploymentViewRule): ProjectId$1;
+    parseDeploymentViewRulePredicate(astRule: DeploymentViewRulePredicate): ProjectId$1;
+    parseDeploymentViewRuleStyle(astRule: DeploymentViewRuleStyle): ProjectId$1;
     parseDeployment(): void;
     parseDeploymentNode(astNode: DeploymentNode): ParsedAstDeployment.Node;
     parseDeployedInstance(astNode: DeployedInstance): ParsedAstDeployment.Instance;
     parseExtendDeployment(astNode: ExtendDeployment): ParsedAstExtend | null;
-    _resolveDeploymentRelationSource(node: DeploymentRelation): ProjectId;
+    _resolveDeploymentRelationSource(node: DeploymentRelation): ProjectId$1;
     parseDeploymentRelation(astNode: DeploymentRelation): ParsedAstDeploymentRelation;
   };
 } & {
   new (...args: any[]): {
     parseViews(): void;
     parseElementView(astNode: ElementView, additionalStyles: any[]): ParsedAstElementView;
-    parseElementViewRule(astRule: ViewRule): ProjectId;
-    parseViewRulePredicate(astNode: ViewRulePredicate): ProjectId;
-    parseViewRuleGlobalPredicateRef(astRule: ViewRuleGlobalPredicateRef | DynamicViewGlobalPredicateRef): ProjectId;
+    parseElementViewRule(astRule: ViewRule): ProjectId$1;
+    parseViewRulePredicate(astNode: ViewRulePredicate): ProjectId$1;
+    parseViewRuleGlobalPredicateRef(astRule: ViewRuleGlobalPredicateRef | DynamicViewGlobalPredicateRef): ProjectId$1;
     parseViewRuleStyleOrGlobalRef(astRule: ViewRuleStyleOrGlobalRef): any;
-    parseViewRuleGroup(astNode: ViewRuleGroup): ProjectId;
-    parseViewRuleRank(astRule: ViewRuleRank): ProjectId;
-    parseViewRuleStyle(astRule: ViewRuleStyle | GlobalStyle): ProjectId;
-    parseViewRuleGlobalStyle(astRule: ViewRuleGlobalStyle): ProjectId;
+    parseViewRuleGroup(astNode: ViewRuleGroup): ProjectId$1;
+    parseViewRuleRank(astRule: ViewRuleRank): ProjectId$1;
+    parseViewRuleStyle(astRule: ViewRuleStyle | GlobalStyle): ProjectId$1;
+    parseViewRuleGlobalStyle(astRule: ViewRuleGlobalStyle): ProjectId$1;
     parseDynamicElementView(astNode: DynamicView, additionalStyles: any[]): ParsedAstDynamicView;
-    parseDynamicViewRule(astRule: DynamicViewRule): ProjectId;
-    parseDynamicViewIncludePredicate(astRule: DynamicViewIncludePredicate): ProjectId;
-    parseDynamicParallelSteps(node: DynamicViewParallelSteps): ProjectId;
-    parseDynamicStep(node: DynamicViewStep): ProjectId | ProjectId;
-    recursiveParseDynamicStepChain(node: DynamicStepChain, callstack?: Array<[source: ProjectId, target: ProjectId]>): ProjectId[];
-    parseDynamicStepSingle(node: DynamicStepSingle): ProjectId;
-    parseAbstractDynamicStep(astnode: AbstractDynamicStep): type_fest0.Writable<type_fest0.Except<ProjectId, "source", {
+    parseDynamicViewRule(astRule: DynamicViewRule): ProjectId$1;
+    parseDynamicViewIncludePredicate(astRule: DynamicViewIncludePredicate): ProjectId$1;
+    parseDynamicParallelSteps(node: DynamicViewParallelSteps): ProjectId$1;
+    parseDynamicStep(node: DynamicViewStep): ProjectId$1 | ProjectId$1;
+    recursiveParseDynamicStepChain(node: DynamicStepChain, callstack?: Array<[source: ProjectId$1, target: ProjectId$1]>): ProjectId$1[];
+    parseDynamicStepSingle(node: DynamicStepSingle): ProjectId$1;
+    parseAbstractDynamicStep(astnode: AbstractDynamicStep): type_fest0.Writable<type_fest0.Except<ProjectId$1, "source", {
       requireExactProps: true;
     }>>;
-    parsePredicate(astNode: ExpressionV2): ProjectId;
-    parseElementPredicate(astNode: FqnExprOrWith): ProjectId;
-    parseElementPredicateOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseElementExpression(astNode: FqnExpr$2): ProjectId;
-    parseElementPredicateWhere(astNode: FqnExprWhere): ProjectId;
-    parseElementPredicateWith(astNode: FqnExprWith): ProjectId;
-    parseRelationPredicate(astNode: RelationExprOrWith): ProjectId;
-    parseRelationPredicateOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationPredicateWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationPredicateWith(astNode: RelationExprWith): ProjectId;
-    parseRelationExpression(astNode: RelationExpr$1): ProjectId;
-    parseFqnRef(astNode: FqnRef$2): ProjectId;
-    parseExpressionV2(astNode: ExpressionV2): ProjectId;
-    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId;
-    parseFqnExprWith(astNode: FqnExprWith): ProjectId;
-    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId;
-    parseFqnExpr(astNode: FqnExpr$2): ProjectId;
-    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId;
-    parseFqnExpressions(astNode: FqnExpressions): ProjectId[];
-    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId;
-    parseRelationExprWith(astNode: RelationExprWith): ProjectId;
-    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId["customRelation"], "expr">;
-    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationExpr(astNode: RelationExpr$1): ProjectId;
-    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId | null;
-    wrapInWhere(expr: ProjectId, condition: ProjectId | null): ProjectId;
+    parsePredicate(astNode: ExpressionV2): ProjectId$1;
+    parseElementPredicate(astNode: FqnExprOrWith): ProjectId$1;
+    parseElementPredicateOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseElementExpression(astNode: FqnExpr$2): ProjectId$1;
+    parseElementPredicateWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseElementPredicateWith(astNode: FqnExprWith): ProjectId$1;
+    parseRelationPredicate(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationPredicateOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationPredicateWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationPredicateWith(astNode: RelationExprWith): ProjectId$1;
+    parseRelationExpression(astNode: RelationExpr$1): ProjectId$1;
+    parseFqnRef(astNode: FqnRef$2): ProjectId$1;
+    parseExpressionV2(astNode: ExpressionV2): ProjectId$1;
+    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId$1;
+    parseFqnExprWith(astNode: FqnExprWith): ProjectId$1;
+    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseFqnExpr(astNode: FqnExpr$2): ProjectId$1;
+    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId$1;
+    parseFqnExpressions(astNode: FqnExpressions): ProjectId$1[];
+    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationExprWith(astNode: RelationExprWith): ProjectId$1;
+    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId$1["customRelation"], "expr">;
+    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationExpr(astNode: RelationExpr$1): ProjectId$1;
+    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId$1 | null;
+    wrapInWhere(expr: ProjectId$1, condition: ProjectId$1 | null): ProjectId$1;
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -2833,19 +2949,19 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
     parseDeploymentView(astNode: DeploymentView): ParsedAstDeploymentView;
-    parseDeploymentViewRule(astRule: DeploymentViewRule): ProjectId;
-    parseDeploymentViewRulePredicate(astRule: DeploymentViewRulePredicate): ProjectId;
-    parseDeploymentViewRuleStyle(astRule: DeploymentViewRuleStyle): ProjectId;
+    parseDeploymentViewRule(astRule: DeploymentViewRule): ProjectId$1;
+    parseDeploymentViewRulePredicate(astRule: DeploymentViewRulePredicate): ProjectId$1;
+    parseDeploymentViewRuleStyle(astRule: DeploymentViewRuleStyle): ProjectId$1;
     parseDeployment(): void;
     parseDeploymentNode(astNode: DeploymentNode): ParsedAstDeployment.Node;
     parseDeployedInstance(astNode: DeployedInstance): ParsedAstDeployment.Instance;
     parseExtendDeployment(astNode: ExtendDeployment): ParsedAstExtend | null;
-    _resolveDeploymentRelationSource(node: DeploymentRelation): ProjectId;
+    _resolveDeploymentRelationSource(node: DeploymentRelation): ProjectId$1;
     parseDeploymentRelation(astNode: DeploymentRelation): ParsedAstDeploymentRelation;
   };
 } & {
@@ -2854,29 +2970,31 @@ declare const DocumentParserFromMixins: {
     parseElementSpecificationNode(specAst: SpecificationElementKind): {};
     parseElementSpecificationNode(specAst: SpecificationDeploymentNodeKind): {};
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -2891,65 +3009,67 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
   };
 } & {
   new (...args: any[]): {
-    parsePredicate(astNode: ExpressionV2): ProjectId;
-    parseElementPredicate(astNode: FqnExprOrWith): ProjectId;
-    parseElementPredicateOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseElementExpression(astNode: FqnExpr$2): ProjectId;
-    parseElementPredicateWhere(astNode: FqnExprWhere): ProjectId;
-    parseElementPredicateWith(astNode: FqnExprWith): ProjectId;
-    parseRelationPredicate(astNode: RelationExprOrWith): ProjectId;
-    parseRelationPredicateOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationPredicateWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationPredicateWith(astNode: RelationExprWith): ProjectId;
-    parseRelationExpression(astNode: RelationExpr$1): ProjectId;
-    parseFqnRef(astNode: FqnRef$2): ProjectId;
-    parseExpressionV2(astNode: ExpressionV2): ProjectId;
-    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId;
-    parseFqnExprWith(astNode: FqnExprWith): ProjectId;
-    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId;
-    parseFqnExpr(astNode: FqnExpr$2): ProjectId;
-    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId;
-    parseFqnExpressions(astNode: FqnExpressions): ProjectId[];
-    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId;
-    parseRelationExprWith(astNode: RelationExprWith): ProjectId;
-    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId["customRelation"], "expr">;
-    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationExpr(astNode: RelationExpr$1): ProjectId;
-    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId | null;
-    wrapInWhere(expr: ProjectId, condition: ProjectId | null): ProjectId;
+    parsePredicate(astNode: ExpressionV2): ProjectId$1;
+    parseElementPredicate(astNode: FqnExprOrWith): ProjectId$1;
+    parseElementPredicateOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseElementExpression(astNode: FqnExpr$2): ProjectId$1;
+    parseElementPredicateWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseElementPredicateWith(astNode: FqnExprWith): ProjectId$1;
+    parseRelationPredicate(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationPredicateOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationPredicateWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationPredicateWith(astNode: RelationExprWith): ProjectId$1;
+    parseRelationExpression(astNode: RelationExpr$1): ProjectId$1;
+    parseFqnRef(astNode: FqnRef$2): ProjectId$1;
+    parseExpressionV2(astNode: ExpressionV2): ProjectId$1;
+    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId$1;
+    parseFqnExprWith(astNode: FqnExprWith): ProjectId$1;
+    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseFqnExpr(astNode: FqnExpr$2): ProjectId$1;
+    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId$1;
+    parseFqnExpressions(astNode: FqnExpressions): ProjectId$1[];
+    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationExprWith(astNode: RelationExprWith): ProjectId$1;
+    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId$1["customRelation"], "expr">;
+    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationExpr(astNode: RelationExpr$1): ProjectId$1;
+    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId$1 | null;
+    wrapInWhere(expr: ProjectId$1, condition: ProjectId$1 | null): ProjectId$1;
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -2964,58 +3084,60 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
   };
 } & {
   new (...args: any[]): {
     parseDeploymentView(astNode: DeploymentView): ParsedAstDeploymentView;
-    parseDeploymentViewRule(astRule: DeploymentViewRule): ProjectId;
-    parseDeploymentViewRulePredicate(astRule: DeploymentViewRulePredicate): ProjectId;
-    parseDeploymentViewRuleStyle(astRule: DeploymentViewRuleStyle): ProjectId;
-    parseFqnRef(astNode: FqnRef$2): ProjectId;
-    parseExpressionV2(astNode: ExpressionV2): ProjectId;
-    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId;
-    parseFqnExprWith(astNode: FqnExprWith): ProjectId;
-    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId;
-    parseFqnExpr(astNode: FqnExpr$2): ProjectId;
-    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId;
-    parseFqnExpressions(astNode: FqnExpressions): ProjectId[];
-    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId;
-    parseRelationExprWith(astNode: RelationExprWith): ProjectId;
-    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId["customRelation"], "expr">;
-    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationExpr(astNode: RelationExpr$1): ProjectId;
-    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId | null;
-    wrapInWhere(expr: ProjectId, condition: ProjectId | null): ProjectId;
+    parseDeploymentViewRule(astRule: DeploymentViewRule): ProjectId$1;
+    parseDeploymentViewRulePredicate(astRule: DeploymentViewRulePredicate): ProjectId$1;
+    parseDeploymentViewRuleStyle(astRule: DeploymentViewRuleStyle): ProjectId$1;
+    parseFqnRef(astNode: FqnRef$2): ProjectId$1;
+    parseExpressionV2(astNode: ExpressionV2): ProjectId$1;
+    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId$1;
+    parseFqnExprWith(astNode: FqnExprWith): ProjectId$1;
+    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseFqnExpr(astNode: FqnExpr$2): ProjectId$1;
+    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId$1;
+    parseFqnExpressions(astNode: FqnExpressions): ProjectId$1[];
+    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationExprWith(astNode: RelationExprWith): ProjectId$1;
+    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId$1["customRelation"], "expr">;
+    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationExpr(astNode: RelationExpr$1): ProjectId$1;
+    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId$1 | null;
+    wrapInWhere(expr: ProjectId$1, condition: ProjectId$1 | null): ProjectId$1;
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -3030,15 +3152,15 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
     parseDeployment(): void;
     parseDeploymentNode(astNode: DeploymentNode): ParsedAstDeployment.Node;
     parseDeployedInstance(astNode: DeployedInstance): ParsedAstDeployment.Instance;
     parseExtendDeployment(astNode: ExtendDeployment): ParsedAstExtend | null;
-    _resolveDeploymentRelationSource(node: DeploymentRelation): ProjectId;
+    _resolveDeploymentRelationSource(node: DeploymentRelation): ProjectId$1;
     parseDeploymentRelation(astNode: DeploymentRelation): ParsedAstDeploymentRelation;
   };
 } & {
@@ -3047,49 +3169,51 @@ declare const DocumentParserFromMixins: {
     parseDeploymentNode(astNode: DeploymentNode): ParsedAstDeployment.Node;
     parseDeployedInstance(astNode: DeployedInstance): ParsedAstDeployment.Instance;
     parseExtendDeployment(astNode: ExtendDeployment): ParsedAstExtend | null;
-    _resolveDeploymentRelationSource(node: DeploymentRelation): ProjectId;
+    _resolveDeploymentRelationSource(node: DeploymentRelation): ProjectId$1;
     parseDeploymentRelation(astNode: DeploymentRelation): ParsedAstDeploymentRelation;
-    parseFqnRef(astNode: FqnRef$2): ProjectId;
-    parseExpressionV2(astNode: ExpressionV2): ProjectId;
-    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId;
-    parseFqnExprWith(astNode: FqnExprWith): ProjectId;
-    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId;
-    parseFqnExpr(astNode: FqnExpr$2): ProjectId;
-    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId;
-    parseFqnExpressions(astNode: FqnExpressions): ProjectId[];
-    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId;
-    parseRelationExprWith(astNode: RelationExprWith): ProjectId;
-    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId["customRelation"], "expr">;
-    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationExpr(astNode: RelationExpr$1): ProjectId;
-    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId | null;
-    wrapInWhere(expr: ProjectId, condition: ProjectId | null): ProjectId;
+    parseFqnRef(astNode: FqnRef$2): ProjectId$1;
+    parseExpressionV2(astNode: ExpressionV2): ProjectId$1;
+    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId$1;
+    parseFqnExprWith(astNode: FqnExprWith): ProjectId$1;
+    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseFqnExpr(astNode: FqnExpr$2): ProjectId$1;
+    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId$1;
+    parseFqnExpressions(astNode: FqnExpressions): ProjectId$1[];
+    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationExprWith(astNode: RelationExprWith): ProjectId$1;
+    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId$1["customRelation"], "expr">;
+    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationExpr(astNode: RelationExpr$1): ProjectId$1;
+    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId$1 | null;
+    wrapInWhere(expr: ProjectId$1, condition: ProjectId$1 | null): ProjectId$1;
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -3104,8 +3228,8 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
   };
@@ -3115,49 +3239,51 @@ declare const DocumentParserFromMixins: {
     parseElement(astNode: Element): ParsedAstElement;
     parseExtendElement(astNode: ExtendElement): ParsedAstExtend | null;
     parseExtendRelation(astNode: ExtendRelation): ParsedAstExtendRelation | null;
-    _resolveRelationSource(node: Relation): ProjectId | ProjectId;
+    _resolveRelationSource(node: Relation): ProjectId$1 | ProjectId$1;
     parseRelation(astNode: Relation): ParsedAstRelation;
-    parseFqnRef(astNode: FqnRef$2): ProjectId;
-    parseExpressionV2(astNode: ExpressionV2): ProjectId;
-    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId;
-    parseFqnExprWith(astNode: FqnExprWith): ProjectId;
-    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId;
-    parseFqnExpr(astNode: FqnExpr$2): ProjectId;
-    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId;
-    parseFqnExpressions(astNode: FqnExpressions): ProjectId[];
-    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId;
-    parseRelationExprWith(astNode: RelationExprWith): ProjectId;
-    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId["customRelation"], "expr">;
-    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationExpr(astNode: RelationExpr$1): ProjectId;
-    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId | null;
-    wrapInWhere(expr: ProjectId, condition: ProjectId | null): ProjectId;
+    parseFqnRef(astNode: FqnRef$2): ProjectId$1;
+    parseExpressionV2(astNode: ExpressionV2): ProjectId$1;
+    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId$1;
+    parseFqnExprWith(astNode: FqnExprWith): ProjectId$1;
+    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseFqnExpr(astNode: FqnExpr$2): ProjectId$1;
+    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId$1;
+    parseFqnExpressions(astNode: FqnExpressions): ProjectId$1[];
+    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationExprWith(astNode: RelationExprWith): ProjectId$1;
+    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId$1["customRelation"], "expr">;
+    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationExpr(astNode: RelationExpr$1): ProjectId$1;
+    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId$1 | null;
+    wrapInWhere(expr: ProjectId$1, condition: ProjectId$1 | null): ProjectId$1;
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -3172,8 +3298,8 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
   };
@@ -3181,29 +3307,31 @@ declare const DocumentParserFromMixins: {
   new (...args: any[]): {
     parseImports(): void;
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -3218,54 +3346,56 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
   };
 } & {
   new (...args: any[]): {
-    parseFqnRef(astNode: FqnRef$2): ProjectId;
-    parseExpressionV2(astNode: ExpressionV2): ProjectId;
-    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId;
-    parseFqnExprWith(astNode: FqnExprWith): ProjectId;
-    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId;
-    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId;
-    parseFqnExpr(astNode: FqnExpr$2): ProjectId;
-    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId;
-    parseFqnExpressions(astNode: FqnExpressions): ProjectId[];
-    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId;
-    parseRelationExprWith(astNode: RelationExprWith): ProjectId;
-    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId["customRelation"], "expr">;
-    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId;
-    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId;
-    parseRelationExpr(astNode: RelationExpr$1): ProjectId;
-    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId | null;
-    wrapInWhere(expr: ProjectId, condition: ProjectId | null): ProjectId;
+    parseFqnRef(astNode: FqnRef$2): ProjectId$1;
+    parseExpressionV2(astNode: ExpressionV2): ProjectId$1;
+    parseFqnExprOrWith(astNode: FqnExprOrWith): ProjectId$1;
+    parseFqnExprWith(astNode: FqnExprWith): ProjectId$1;
+    parseFqnExprOrWhere(astNode: FqnExprOrWhere): ProjectId$1;
+    parseFqnExprWhere(astNode: FqnExprWhere): ProjectId$1;
+    parseFqnExpr(astNode: FqnExpr$2): ProjectId$1;
+    parseFqnRefExpr(astNode: FqnRefExpr): ProjectId$1;
+    parseFqnExpressions(astNode: FqnExpressions): ProjectId$1[];
+    parseRelationExprOrWith(astNode: RelationExprOrWith): ProjectId$1;
+    parseRelationExprWith(astNode: RelationExprWith): ProjectId$1;
+    parseCustomRelationProperties(custom: CustomRelationProperties | undefined): type_fest0.Except<ProjectId$1["customRelation"], "expr">;
+    parseRelationExprOrWhere(astNode: RelationExprOrWhere): ProjectId$1;
+    parseRelationExprWhere(astNode: RelationExprWhere): ProjectId$1;
+    parseRelationExpr(astNode: RelationExpr$1): ProjectId$1;
+    parseInlineKindCondition(astNode: OutgoingRelationExpr): ProjectId$1 | null;
+    wrapInWhere(expr: ProjectId$1, condition: ProjectId$1 | null): ProjectId$1;
     isValid: IsValidFn;
+    docUri: string;
+    docPathInProject: string;
     readonly services: LikeC4Services;
     readonly doc: ParsedLikeC4LangiumDocument;
     readonly project: Project;
     logError(error: unknown, astNode?: AstNode | Reference<AstNode>, level?: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification"): void;
     tryParse<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", node: N | undefined, fn: (node: NoInfer<N>) => T | undefined): T | undefined;
     tryMap<N extends AstNode, T>(level: "base" | "model" | "deployment" | "fqnref" | "relation" | "views" | "globals" | "imports" | "specification", iterable: ReadonlyArray<N>, fn: (node: N) => T | undefined): T[];
-    resolveFqn(node: FqnReferenceable): ProjectId;
+    resolveFqn(node: FqnReferenceable): ProjectId$1;
     getAstNodePath(node: AstNode): string;
     getMetadata(metadataAstNode: MetadataProperty | undefined): {
       [key: string]: string | string[];
     } | undefined;
-    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId | undefined;
+    parseMarkdownOrString(markdownOrString: MarkdownOrString | undefined): ProjectId$1 | undefined;
     convertTags<E extends {
       tags?: Tags;
     }>(withTags?: E | undefined): any;
     parseTags<E extends {
       tags?: Tags;
-    }>(withTags?: E): ProjectId<ProjectId> | null;
-    convertLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseLinks(source?: LinkProperty["$container"]): ProjectId<ProjectId> | undefined;
-    parseIconProperty(prop: IconProperty | undefined): ProjectId | undefined;
+    }>(withTags?: E): ProjectId$1<ProjectId$1> | null;
+    convertLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseLinks(source?: LinkProperty["$container"]): ProjectId$1<ProjectId$1> | undefined;
+    parseIconProperty(prop: IconProperty | undefined): ProjectId$1 | undefined;
     parseImageAlias(value: string): string | undefined;
-    parseColorLiteral(astNode: ColorLiteral$1): ProjectId | undefined;
+    parseColorLiteral(astNode: ColorLiteral$1): ProjectId$1 | undefined;
     parseElementStyle(elementProps: Array<ElementProperty> | ElementStyleProperty | undefined): ParsedElementStyle;
     parseStyleProps(styleProps: Array<StyleProperty> | undefined): ParsedElementStyle;
     parseBaseProps(props: {
@@ -3280,8 +3410,8 @@ declare const DocumentParserFromMixins: {
       technology?: string | undefined;
     }): {
       title?: string;
-      summary?: ProjectId;
-      description?: ProjectId;
+      summary?: ProjectId$1;
+      description?: ProjectId$1;
       technology?: string;
     };
   };
@@ -3291,7 +3421,7 @@ declare class LikeC4ModelParser {
   private services;
   protected cachedParsers: any;
   constructor(services: LikeC4Services);
-  documents(projectId: ProjectId): Stream<ParsedLikeC4LangiumDocument>;
+  documents(projectId: ProjectId$1): Stream<ParsedLikeC4LangiumDocument>;
   parse(doc: LangiumDocument): ParsedLikeC4LangiumDocument;
   forDocument(doc: LangiumDocument): DocumentParser;
   private createParser;
@@ -3311,24 +3441,26 @@ declare class LikeC4ModelChanges {
     change
   }: {
     lookup: ViewLocateResult;
-    change: Exclude<ViewChange, ViewChange.SaveViewSnapshot | ViewChange.ResetManualLayout>;
+    change: Exclude<ViewChange, ViewChange.SaveViewSnapshot | ViewChange.ResetManualLayout | ViewChange.ChangeProperty>;
   }): {
     modifiedRange: Range;
     edits: TextEdit[];
   };
+  protected applyTextEdits(doc: ParsedLikeC4LangiumDocument, edits: TextEdit[]): Promise<boolean>;
 } //#endregion
 //#region src/LikeC4LanguageServices.d.ts
 interface LikeC4LanguageServices {
   readonly views: LikeC4Views;
   readonly builder: LikeC4ModelBuilder;
   readonly workspaceUri: URI;
+  readonly workspacePath: string;
   readonly projectsManager: ProjectsManager;
   readonly editor: LikeC4ModelChanges;
   /**
    * Returns all projects with relevant documents
    */
-  projects(): NonEmptyArray<{
-    id: ProjectId;
+  projects(): NonEmptyArray$1<{
+    id: ProjectId$1;
     folder: URI;
     title: string;
     documents: ReadonlyArray<URI>;
@@ -3337,8 +3469,8 @@ interface LikeC4LanguageServices {
   /**
    * Returns project by ID, returns default project if no ID is specified
    */
-  project(projectId?: ProjectId): {
-    id: ProjectId;
+  project(projectId?: ProjectId$1): {
+    id: ProjectId$1;
     folder: URI;
     title: string;
     documents: ReadonlyArray<URI>;
@@ -3355,21 +3487,21 @@ interface LikeC4LanguageServices {
    *
    * If no {@link project} is specified, returns for default project
    */
-  computedModel(project?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownComputed>>;
+  computedModel(project?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownComputed>>;
   /**
    * Returns {@link LikeC4Model} of the specified project, with layouted views {@link LayoutedView}
    * Ready for rendering. Applies manual layouts if available.
    *
    * If no {@link project} is specified, returns for default project
    */
-  layoutedModel(project?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownLayouted>>;
+  layoutedModel(project?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<LikeC4Model<UnknownLayouted>>;
   /**
    * Returns diagrams (i.e. layouted views {@link LayoutedView}) for the specified project
    * Applies manual layouts if available.
    *
    * If no {@link project} is specified, returns diagrams for default project
    */
-  diagrams(project?: ProjectId | undefined, cancelToken?: CancellationToken$1): Promise<LayoutedView[]>;
+  diagrams(project?: ProjectId$1 | undefined, cancelToken?: CancellationToken$1): Promise<LayoutedView$1[]>;
   getErrors(): Array<{
     message: string;
     line: number;
@@ -3403,7 +3535,7 @@ interface LikeC4LanguageServices {
  */
 interface FormatOptions {
   /** Include all documents from these projects. */
-  projectIds?: ReadonlyArray<ProjectId>;
+  projectIds?: ReadonlyArray<ProjectId$1>;
   /** Include these specific documents (by URI string). */
   documentUris?: ReadonlyArray<string>;
   /** Size of a tab in spaces (default: 2). */
@@ -3462,7 +3594,7 @@ declare class LikeC4DocumentSymbolProvider implements DocumentSymbolProvider {
   protected getSpecSymbol(astSpec: SpecificationRule): DocumentSymbol[];
   protected getModelSymbol(astModel: Model): DocumentSymbol[];
   protected getDeploymentModelSymbol(astModel: ModelDeployments): DocumentSymbol[];
-  protected getElementsSymbol(el: Element | Relation | ExtendElement): DocumentSymbol[];
+  protected getElementsSymbol(el: Element | Relation | ExtendElement, parentFqn?: string): DocumentSymbol[];
   protected getExtendElementSymbol(astElement: ExtendElement): DocumentSymbol[];
   protected getElementSymbol(astElement: Element): DocumentSymbol[];
   protected getModelViewsSymbol(astViews: ModelViews): DocumentSymbol[];
@@ -3499,7 +3631,7 @@ declare class LikeC4HoverProvider extends AstNodeHoverProvider {
    * @param projectId - The project identifier for constructing view links.
    * @returns Markdown string with model details, or undefined if no details available.
    */
-  protected getElementModelHover(model: ElementModel, projectId: ProjectId): string | undefined;
+  protected getElementModelHover(model: ElementModel, projectId: ProjectId$1): string | undefined;
   /**
    * Builds hover content for a deployment node (id, title, kind, summary).
    * @param node - The deployment node AST node to generate hover content for.
@@ -3622,4 +3754,123 @@ interface LikeC4AddedServices {
 }
 type LikeC4Services = LangiumServices & LikeC4AddedServices;
 //#endregion
-export { LikeC4Views as a, LikeC4SharedServices as i, LikeC4ModelBuilder as n, ProjectsManager as o, LikeC4Services as r, LikeC4LanguageServices as t };
+//#region ../language-services/dist/_chunks/options.d.mts
+//#region src/common/LikeC4.d.ts
+interface LikeC4Langium {
+  shared: LikeC4SharedServices;
+  likec4: LikeC4Services;
+}
+declare class LikeC4 {
+  protected readonly langium: LikeC4Langium;
+  protected readonly logger: Logger;
+  constructor(langium: LikeC4Langium, logger?: Logger);
+  /**
+   * File system path to the workspace root
+   */
+  get workspace(): any;
+  /**
+   * URI of the workspace root
+   */
+  get workspaceURI(): any;
+  /**
+   * URL of the workspace root
+   */
+  get workspaceURL(): any;
+  get languageServices(): LikeC4LanguageServices;
+  get projectsManager(): ProjectsManager;
+  get viewsService(): LikeC4Views;
+  get modelBuilder(): LikeC4ModelBuilder;
+  private get LangiumDocuments();
+  ensureSingleProject(): void;
+  /**
+   * Diagram is a computed view, layouted using Graphviz
+   * If diagram has manual layout, it will be used.
+   * Used in React components
+   */
+  diagrams(project?: string | undefined): Promise<LayoutedView[]>;
+  /**
+   * Builds LikeC4Model from all documents
+   * Only computes view predicates {@link ComputedView} - i.e. no layout
+   * Not ready for rendering, but enough to traverse
+   *
+   * Sync version does not read manual layouts
+   * Use {@link computedModel} for a version that includes manual layouts
+   */
+  syncComputedModel(project?: string | undefined): LikeC4Model.Computed;
+  /**
+   * Builds LikeC4Model from all documents
+   * Only computes view predicates {@link ComputedView} - i.e. no layout
+   * Not ready for rendering, but enough to traverse
+   */
+  computedModel(project?: string | undefined): Promise<LikeC4Model.Computed>;
+  projects(): NonEmptyArray<ProjectId>;
+  /**
+   * Same as {@link computedModel()}, but also applies layout
+   * Ready for rendering
+   */
+  layoutedModel(project?: string | undefined): Promise<LikeC4Model.Layouted>;
+  getErrors(): Array<{
+    message: string;
+    line: number;
+    range: {
+      start: {
+        line: number;
+        character: number;
+      };
+      end: {
+        line: number;
+        character: number;
+      };
+    };
+    sourceFsPath: string;
+  }>;
+  hasErrors(): boolean;
+  /**
+   * @returns true if there are errors
+   */
+  printErrors(): boolean;
+  /**
+   * Returns the number of parsed documents in the workspace
+   */
+  documentCount(): number;
+  /**
+   * @returns a function to dispose the listener
+   */
+  onModelUpdate(listener: () => void): () => void;
+  /**
+   * Formats documents and returns a map of document URI → formatted source text.
+   *
+   * Target selection uses union semantics:
+   * - Omit both `projects` and `documentUris` to format **all** documents.
+   * - Provide `projects` to include all documents from those projects.
+   * - Provide `documentUris` to include specific documents.
+   * - Provide both to format the **union** (deduplicated).
+   */
+  format(options?: LikeC4FormatOptions): Promise<Map<string, string>>;
+  dispose(): Promise<void>;
+  [Symbol.asyncDispose](): Promise<void>;
+}
+/**
+ * Options for {@link LikeC4.format}.
+ *
+ * Same as {@link FormatOptions} but uses project name strings instead of {@link ProjectId}.
+ */
+interface LikeC4FormatOptions {
+  /** Include all documents from these projects (by name). */
+  projects?: ReadonlyArray<string>;
+  /** Include these specific documents (by URI string). */
+  documentUris?: ReadonlyArray<string>;
+  /** Size of a tab in spaces (default: 2). */
+  tabSize?: number;
+  /** Prefer spaces over tabs (default: true). */
+  insertSpaces?: boolean;
+  /** Trim trailing whitespace on a line. */
+  trimTrailingWhitespace?: boolean;
+  /** Insert a newline character at the end of the file if one does not exist. */
+  insertFinalNewline?: boolean;
+  /** Trim all newlines after the final newline at the end of the file. */
+  trimFinalNewlines?: boolean;
+} //#endregion
+//#region src/common/options.d.ts
+//#endregion
+export { LikeC4LanguageServices as n, LikeC4 as t };