@likec4/language-server 1.57.0 → 1.58.0

package/dist/_chunks/module.d.mts

@@ -41,335 +41,13 @@ 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).
- * Used in `startsWith` checks to determine if a document belongs to a project.
- */
-type ProjectFolder = Tagged<string, 'ProjectFolder'>;
-declare function ProjectFolder(folder: URI | string): ProjectFolder;
-interface Project {
-  id: ProjectId$1;
-  folderUri: URI;
-  config: LikeC4ProjectConfig;
-}
-interface ProjectData extends Project {
-  id: ProjectId$1;
-  folder: ProjectFolder;
-  config: LikeC4ProjectConfig;
-  configUri: URI;
-  folderUri: URI;
-  exclude?: {
-    (test: string): boolean;
-  };
-  /**
-   * Resolved include paths with both URI and folder string representations.
-   * These are additional directories that are part of this project.
-   */
-  includePaths?: NonEmptyArray<{
-    uri: URI;
-    folder: ProjectFolder;
-  }>;
-  /**
-   * Normalized include configuration (paths, maxDepth, fileThreshold).
-   */
-  includeConfig: IncludeConfig;
-}
-type RegisterProjectOptions = {
-  config: LikeC4ProjectConfig | LikeC4ProjectConfigInput;
-} & ({
-  configUri: URI | string;
-} | {
-  folderUri: URI | string;
-});
-declare class ProjectsManager {
-  #private;
-  protected services: LikeC4SharedServices;
-  /**
-   * The global project ID used for all documents
-   * that are not part of a specific project.
-   */
-  static readonly DefaultProjectId: ProjectId$1;
-  constructor(services: LikeC4SharedServices);
-  /**
-   * Checks if a document is excluded by workspace-level patterns.
-   * These patterns come from VS Code settings and take precedence over project-level excludes.
-   */
-  isExcludedByWorkspace(uri: NormalizedUri | URI): boolean;
-  /**
-   * Updates the workspace-level exclude patterns from VS Code settings.
-   * Called during initial server startup; dynamic changes restart the server.
-   */
-  setWorkspaceExcludePatterns(patterns: string[] | undefined): void;
-  /**
-   * Returns:
-   *  - configured default project ID if set
-   *  - the default project ID if there are no projects.
-   *  - the ID of the only project
-   *  - undefined if there are multiple projects.
-   */
-  get defaultProjectId(): ProjectId$1 | undefined;
-  set defaultProjectId(id: string | ProjectId$1 | undefined);
-  get default(): ProjectData;
-  get all(): NonEmptyReadonlyArray<ProjectId$1>;
-  getProject(arg: ProjectId$1 | LangiumDocument): ProjectData;
-  /**
-   * Returns all projects that overlap with the specified folder (is parent or child)
-   */
-  findOverlaped(folder: URI | string): ReadonlyArray<ProjectData>;
-  /**
-   * Validates and ensures the project ID.
-   * If no project ID is specified, returns default project ID
-   * If there are multiple projects and default project is not set, throws an error
-   */
-  ensureProjectId(projectId?: ProjectId$1 | undefined): ProjectId$1;
-  /**
-   * 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;
-  hasMultipleProjects(): boolean;
-  /**
-   * Checks if given document (or URI) must be excluded from processing.
-   */
-  isExcluded(document: DocOrUri): boolean;
-  /**
-   * Checks if given document (or URI) must be excluded in the context of the project.
-   */
-  isExcluded(projectId: ProjectId$1, 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;
-  /**
-   * Registers likec4 project by config file.
-   */
-  registerConfigFile(configUri: URI, cancelToken?: Cancellation.CancellationToken): Promise<ProjectData>;
-  /**
-   * Registers (or reloads) likec4 project by config file or config object.
-   * If there is some project registered at same folder, it will be reloaded.
-   */
-  registerProject(opts: RegisterProjectOptions, cancelToken?: Cancellation.CancellationToken): Promise<ProjectData>;
-  /**
-   * Determines which project the given document belongs to.
-   * If the document does not belong to any project, returns the default project ID.
-   */
-  ownerProjectId(document: LangiumDocument | URI | string): ProjectId$1;
-  /**
-   * 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?: Cancellation.CancellationToken): Promise<void>;
-  protected _reloadProjects(cancelToken?: Cancellation.CancellationToken): Promise<void>;
-  protected uniqueProjectId(name: string): ProjectId$1;
-  protected resetCaches(): void;
-  rebuildProject(projectId: ProjectId$1, cancelToken?: Cancellation.CancellationToken): Promise<void>;
-  /**
-   * Returns all include paths from all projects.
-   * Used by WorkspaceManager to scan additional directories for C4 files.
-   */
-  getAllIncludePaths(): Array<{
-    projectId: ProjectId$1;
-    includePath: URI;
-    includeConfig: IncludeConfig;
-  }>;
-  /**
-   * Register a listener to be called when the projects configuration has changed.
-   * @returns A disposable that can be used to unregister the callback.
-   */
-  onProjectsUpdate(callback: () => void): Disposable;
-  private getWorkspaceFolder;
-  private notifyListeners;
-  private updateIncludesExcludes;
-  private warnIfConfigOverride;
-}
-//#endregion
-//#region src/filesystem/types.d.ts
-interface FileNode extends FileSystemNode {
-  readonly isFile: true;
-  readonly isDirectory: false;
-}
-interface FileSystemProvider$1 extends FileSystemProvider {
-  /**
-   * Scans the project files for the given URI.
-   * @returns The list of file system entries that are contained within the specified directory.
-   */
-  scanProjectFiles(folderUri: URI): Promise<FileNode[]>;
-  /**
-   * Loads the project config from the given file.
-   * @returns The project config.
-   * @throws Error if the file does not exist or is not a valid project config.
-   */
-  loadProjectConfig(filepath: URI): Promise<LikeC4ProjectConfig>;
-  /**
-   * Reads the directory and returns LikeC4 files.
-   *
-   * @param options.recursive If true, recursively reads the directory,
-   * @param options.maxDepth Maximum depth to traverse when recursive is true (default: Infinity)
-   */
-  readDirectory(uri: URI, options?: {
-    recursive?: boolean;
-    maxDepth?: number;
-  }): Promise<FileNode[]>;
-  /**
-   * Finds all files in the given directory, matching the given filter.
-   */
-  scanDirectory(directory: URI, filter: (filepath: string, isDirectory: boolean) => boolean): Promise<FileNode[]>;
-  /**
-   * Writes the content to the file system.
-   * Used by manual layouts.
-   */
-  writeFile(uri: URI, content: string): Promise<void>;
-  /**
-   * Deletes the file from the file system.
-   * Used by manual layouts.
-   * @return true if the file was deleted, false if the file did not exist.
-   */
-  deleteFile(uri: URI): Promise<boolean>;
-}
-interface FileSystemModuleContext extends FileSystemWatcherModuleContext {
-  fileSystemProvider: () => FileSystemProvider$1;
-}
-interface FileSystemWatcherModuleContext {
-  fileSystemWatcher: (services: LikeC4SharedServices) => FileSystemWatcher;
-}
-interface FileSystemWatcher extends AsyncDisposable {
-  /**
-   * Watches a folder for changes and triggers a reload of the documents and projects.
-   */
-  watch(folder: string): void;
-}
-interface LikeC4ManualLayoutsModuleContext {
-  manualLayouts: (services: LikeC4SharedServices) => LikeC4ManualLayouts;
-}
-type ManualLayoutsSnapshot = {
-  hash: string;
-  views: Record<ViewId$1, LayoutedView$1>;
-};
-type ManualLayoutUpdateEvent = {
-  updated: URI;
-  projectId: ProjectId$1;
-  viewId: ViewId$1;
-} | {
-  removed: URI;
-  projectId: ProjectId$1;
-  /**
-   * Missing if triggered by FS event (file was deleted)
-   */
-  viewId?: ViewId$1;
-};
-type ManualLayoutUpdateListener = (event: ManualLayoutUpdateEvent) => void;
-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>;
-  read(project: Project): Promise<ManualLayoutsSnapshot | null>;
-  write(project: Project, layouted: LayoutedView$1): Promise<Location>;
-  remove(project: Project, view: ViewId$1): Promise<Location | null>;
-  clearCaches(): void;
-  /**
-   * Registers a listener for manual layout updates.
-   * The listener will be called when a manual layout is created, updated, or deleted.
-   */
-  onManualLayoutUpdate(listener: ManualLayoutUpdateListener): Disposable;
-  /**
-   * Handles file system updates for manual layouts.
-   * Used by the file system watcher to notify the manual layouts module of changes.
-   * @param event The file system event
-   */
-  handleFileSystemUpdate(event: {
-    update: URI;
-    delete?: never;
-  } | {
-    delete: URI;
-    update?: never;
-  }): Promise<void>;
-}
-//#endregion
-//#region src/filesystem/noop.d.ts
-declare const NoFileSystemWatcher: FileSystemWatcherModuleContext;
-declare const NoFileSystem: FileSystemModuleContext;
-declare const NoLikeC4ManualLayouts: LikeC4ManualLayoutsModuleContext;
-//#endregion
-//#region src/filesystem/LikeC4FileSystem.d.ts
-declare const WithFileSystem: (enableWatcher?: boolean) => FileSystemModuleContext;
-//#endregion
-//#region src/filesystem/ChokidarWatcher.d.ts
-declare const WithChokidarWatcher: FileSystemWatcherModuleContext;
-//#endregion
-//#region src/filesystem/LikeC4ManualLayouts.d.ts
-declare const WithLikeC4ManualLayouts: LikeC4ManualLayoutsModuleContext;
-//#endregion
-//#region src/formatting/LikeC4Formatter.d.ts
-type QuoteStyle = 'single' | 'double' | 'ignore' | 'auto';
-interface LikeC4FormatterOptions {
-  quoteStyle: QuoteStyle;
-}
-type ExtendedFormattingCommandType = 'normalizeQuotes';
-interface ExtendedFormattingCommand {
-  type: ExtendedFormattingCommandType;
-  region: FormattingRegion;
-}
-declare class LikeC4Formatter extends AbstractFormatter {
-  protected options: LikeC4FormatterOptions;
-  extendedFormattingCommands: ExtendedFormattingCommand[];
-  constructor(services: LikeC4Services);
-  protected doDocumentFormat(document: LangiumDocument, options: FormattingOptions, range?: Range): TextEdit[];
-  protected format(node: AstNode): void;
-  protected formatTags(node: AstNode): void;
-  protected formatDeploymentRelation(node: AstNode): void;
-  protected formatExtendDeployment(node: AstNode): void;
-  protected formatRelation(node: AstNode): void;
-  protected removeIndentFromTopLevelStatements(node: AstNode): void;
-  protected indentContentInBraces(node: AstNode): void;
-  protected appendKeywordsWithSpace(node: AstNode): void;
-  protected formatView(node: AstNode): void;
-  protected formatLeafProperty(node: AstNode): void;
-  protected formatLinkProperty(node: AstNode): void;
-  protected formatNavigateToProperty(node: AstNode): void;
-  protected formatAutolayoutProperty(node: AstNode): void;
-  protected formatMetadataProperty(node: AstNode): void;
-  protected formatElementDeclaration(node: AstNode): void;
-  protected formatExtendElement(node: AstNode): void;
-  protected formatGlobals(node: AstNode): void;
-  protected formatImports(node: AstNode): void;
-  protected formatSpecificationRule(node: AstNode): void;
-  protected formatWithPredicate(node: AstNode): void;
-  protected formatDeploymentNodeDeclaration(node: AstNode): void;
-  protected formatDeployedInstance(node: AstNode): void;
-  protected formatViewRuleGlobalStyle(node: AstNode): void;
-  protected formatViewRuleGlobalPredicate(node: AstNode): void;
-  protected formatViewRuleGroup(node: AstNode): void;
-  protected formatViewRuleStyle(node: AstNode): void;
-  protected formatWhereExpression(node: AstNode): void;
-  protected formatWhereRelationExpression(node: AstNode): void;
-  protected formatWhereElementExpression(node: AstNode): void;
-  protected formatIncludeExcludeExpressions(node: AstNode): void;
-  protected formatRelationExpression(node: AstNode): void;
-  private findPredicateExpressionRoot;
-  private on;
-  private doExtendedFormatting;
-  protected normalizeQuotes(node: AstNode): void;
-  private quotesNormalizerFactory;
-  private escapeQuotesInternalQuotes;
-  private getAutoQuoteStyle;
-  private onConfigurationUpdate;
+//#region src/utils/disposable.d.ts
+declare abstract class ADisposable implements Disposable {
+  protected toDispose: Disposable[];
+  protected isDisposed: boolean;
+  onDispose(...disposable: Disposable[]): void;
+  dispose(): void;
+  protected throwIfDisposed(): void;
 }
 //#endregion
 //#region src/generated/ast.d.ts
@@ -654,9 +332,9 @@ interface DynamicViewIncludePredicate extends langium.AstNode {
 }
 declare const DynamicViewIncludePredicate = "DynamicViewIncludePredicate";
 interface DynamicViewParallelSteps extends langium.AstNode {
-  readonly $container: DynamicViewBody;
+  readonly $container: DynamicViewBody | DynamicViewParallelSteps;
   readonly $type: 'DynamicViewParallelSteps';
-  steps: Array<DynamicViewStep>;
+  steps: Array<DynamicViewParallelSteps | DynamicViewStep>;
 }
 declare const DynamicViewParallelSteps = "DynamicViewParallelSteps";
 interface DynamicViewRef extends langium.AstNode {
@@ -1752,95 +1430,426 @@ interface ParsedAstExtendRelation {
     [key: string]: string | string[];
   };
 }
-interface ParsedAstRelation {
-  id: c4.RelationId;
-  astPath: string;
-  source: c4.FqnRef.ModelRef;
-  target: c4.FqnRef.ModelRef;
-  kind?: c4.RelationshipKind;
-  tags?: c4.NonEmptyArray<c4.Tag>;
-  title: string;
-  description?: c4.MarkdownOrString;
-  technology?: string;
-  color?: c4.Color;
-  line?: c4.RelationshipLineType;
-  head?: c4.RelationshipArrowType;
-  tail?: c4.RelationshipArrowType;
-  links?: c4.NonEmptyArray<c4.Link>;
-  navigateTo?: c4.ViewId;
-  metadata?: {
-    [key: string]: string | string[];
-  };
+interface ParsedAstRelation {
+  id: c4.RelationId;
+  astPath: string;
+  source: c4.FqnRef.ModelRef;
+  target: c4.FqnRef.ModelRef;
+  kind?: c4.RelationshipKind;
+  tags?: c4.NonEmptyArray<c4.Tag>;
+  title: string;
+  description?: c4.MarkdownOrString;
+  technology?: string;
+  color?: c4.Color;
+  line?: c4.RelationshipLineType;
+  head?: c4.RelationshipArrowType;
+  tail?: c4.RelationshipArrowType;
+  links?: c4.NonEmptyArray<c4.Link>;
+  navigateTo?: c4.ViewId;
+  metadata?: {
+    [key: string]: string | string[];
+  };
+}
+type ParsedAstDeployment = Simplify<MergeExclusive<ParsedAstDeployment.Node, ParsedAstDeployment.Instance>>;
+declare namespace ParsedAstDeployment {
+  type Node = c4.DeploymentNode;
+  type Instance = Omit<c4.DeployedInstance, 'element'> & {
+    readonly element: c4.FqnRef.ModelRef;
+  };
+}
+type ParsedAstDeploymentRelation = c4.DeploymentRelationship & {
+  astPath: string;
+};
+type ParsedAstGlobals = Writable<c4.ModelGlobals>;
+interface ParsedAstElementView {
+  id: c4.ViewId;
+  viewOf?: c4.Fqn;
+  extends?: c4.ViewId;
+  astPath: string;
+  title: string | null;
+  description: c4.MarkdownOrString | null;
+  tags: c4.NonEmptyArray<c4.Tag> | null;
+  links: c4.NonEmptyArray<c4.Link> | null;
+  rules: c4.ElementViewRule[];
+}
+interface ParsedAstDynamicView {
+  id: c4.ViewId;
+  astPath: string;
+  title: string | null;
+  description: c4.MarkdownOrString | null;
+  tags: c4.NonEmptyArray<c4.Tag> | null;
+  links: c4.NonEmptyArray<c4.Link> | null;
+  steps: c4.DynamicViewStep[];
+  rules: Array<c4.DynamicViewRule>;
+  variant: c4.DynamicViewDisplayVariant | undefined;
+}
+interface ParsedAstDeploymentView {
+  id: c4.ViewId;
+  astPath: string;
+  title: string | null;
+  description: c4.MarkdownOrString | null;
+  tags: c4.NonEmptyArray<c4.Tag> | null;
+  links: c4.NonEmptyArray<c4.Link> | null;
+  rules: Array<c4.DeploymentViewRule>;
+}
+type ParsedAstView = ParsedAstElementView | ParsedAstDynamicView | ParsedAstDeploymentView;
+interface AstNodeDescriptionWithFqn extends AstNodeDescription {
+  likec4ProjectId: c4.ProjectId;
+  id: c4.Fqn;
+}
+type LikeC4AstNode = ValueOf<ConditionalPick<LikeC4AstType, AstNode>>;
+type LikeC4DocumentDiagnostic = Diagnostic & DiagnosticInfo<LikeC4AstNode>;
+interface LikeC4DocumentProps {
+  diagnostics?: Array<LikeC4DocumentDiagnostic>;
+  c4Specification?: ParsedAstSpecification;
+  c4Elements?: ParsedAstElement[];
+  c4ExtendElements?: ParsedAstExtend[];
+  c4ExtendDeployments?: ParsedAstExtend[];
+  c4ExtendRelations?: ParsedAstExtendRelation[];
+  c4Relations?: ParsedAstRelation[];
+  c4Globals?: ParsedAstGlobals;
+  c4Views?: ParsedAstView[];
+  c4Deployments?: ParsedAstDeployment[];
+  c4DeploymentRelations?: ParsedAstDeploymentRelation[];
+  c4Imports?: MultiMap<c4.ProjectId, c4.Fqn, Set<c4.Fqn>>;
+}
+type LikeC4GrammarDocument = Omit<LangiumDocument<LikeC4Grammar>, 'diagnostics'>;
+interface LikeC4LangiumDocument extends LikeC4GrammarDocument, LikeC4DocumentProps {
+  likec4ProjectId: c4.ProjectId;
+}
+interface ParsedLikeC4LangiumDocument extends LikeC4GrammarDocument, Required<LikeC4DocumentProps> {
+  likec4ProjectId: c4.ProjectId;
+}
+//#endregion
+//#region src/workspace/ProjectsManager.d.ts
+type NormalizedUri = Tagged<string, 'NormalizedUri'>;
+type DocOrUri = LangiumDocument | string | URI;
+/**
+ * A tagged string that represents a project folder URI (with trailing slash).
+ * Used in `startsWith` checks to determine if a document belongs to a project.
+ */
+type ProjectFolder = Tagged<string, 'ProjectFolder'>;
+declare function ProjectFolder(folder: URI | string): ProjectFolder;
+interface Project {
+  id: ProjectId$1;
+  folderUri: URI;
+  config: LikeC4ProjectConfig;
+}
+interface ProjectData extends Project {
+  id: ProjectId$1;
+  folder: ProjectFolder;
+  config: LikeC4ProjectConfig;
+  configUri: URI;
+  folderUri: URI;
+  exclude?: {
+    (test: string): boolean;
+  };
+  /**
+   * Resolved include paths with both URI and folder string representations.
+   * These are additional directories that are part of this project.
+   */
+  includePaths?: NonEmptyArray<{
+    uri: URI;
+    folder: ProjectFolder;
+  }>;
+  /**
+   * Normalized include configuration (paths, maxDepth, fileThreshold).
+   */
+  includeConfig: IncludeConfig;
+}
+type RegisterProjectOptions = {
+  config: LikeC4ProjectConfig | LikeC4ProjectConfigInput;
+} & ({
+  configUri: URI | string;
+} | {
+  folderUri: URI | string;
+});
+declare class ProjectsManager extends ADisposable {
+  #private;
+  protected services: LikeC4SharedServices;
+  /**
+   * The global project ID used for all documents
+   * that are not part of a specific project.
+   */
+  static readonly DefaultProjectId: ProjectId$1;
+  constructor(services: LikeC4SharedServices);
+  /**
+   * Checks if a document is excluded by workspace-level patterns.
+   * These patterns come from VS Code settings and take precedence over project-level excludes.
+   */
+  isExcludedByWorkspace(uri: NormalizedUri | URI): boolean;
+  /**
+   * Updates the workspace-level exclude patterns from VS Code settings.
+   * Called during initial server startup; dynamic changes restart the server.
+   */
+  setWorkspaceExcludePatterns(patterns: string[] | undefined): void;
+  /**
+   * Returns:
+   *  - configured default project ID if set
+   *  - the default project ID if there are no projects.
+   *  - the ID of the only project
+   *  - undefined if there are multiple projects.
+   */
+  get defaultProjectId(): ProjectId$1 | undefined;
+  set defaultProjectId(id: string | ProjectId$1 | undefined);
+  get default(): ProjectData;
+  get all(): NonEmptyReadonlyArray<ProjectId$1>;
+  getProject(arg: ProjectId$1 | LangiumDocument): ProjectData;
+  /**
+   * Returns all projects that overlap with the specified folder (is parent or child)
+   */
+  findOverlaped(folder: URI | string): ReadonlyArray<ProjectData>;
+  /**
+   * Validates and ensures the project ID.
+   * If no project ID is specified, returns default project ID
+   * If there are multiple projects and default project is not set, throws an error
+   */
+  ensureProjectId(projectId?: ProjectId$1 | undefined): ProjectId$1;
+  /**
+   * 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;
+  hasMultipleProjects(): boolean;
+  /**
+   * Checks if given document (or URI) must be excluded from processing.
+   */
+  isExcluded(document: DocOrUri): boolean;
+  /**
+   * Checks if given document (or URI) must be excluded in the context of the project.
+   */
+  isExcluded(projectId: ProjectId$1, 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;
+  /**
+   * Registers likec4 project by config file.
+   */
+  registerConfigFile(configUri: URI, cancelToken?: Cancellation.CancellationToken): Promise<ProjectData>;
+  /**
+   * Registers (or reloads) likec4 project by config file or config object.
+   * If there is some project registered at same folder, it will be reloaded.
+   */
+  registerProject(opts: RegisterProjectOptions, cancelToken?: Cancellation.CancellationToken): Promise<ProjectData>;
+  /**
+   * Determines which project the given document belongs to.
+   * If the document does not belong to any project, returns the default project ID.
+   */
+  ownerProjectId(document: LangiumDocument | URI | string): ProjectId$1;
+  /**
+   * 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?: Cancellation.CancellationToken): Promise<void>;
+  protected _reloadProjects(cancelToken?: Cancellation.CancellationToken): Promise<void>;
+  protected uniqueProjectId(name: string): ProjectId$1;
+  protected resetCaches(): void;
+  rebuildProject(projectId: ProjectId$1, cancelToken?: Cancellation.CancellationToken): Promise<void>;
+  /**
+   * Returns all include paths from all projects.
+   * Used by WorkspaceManager to scan additional directories for C4 files.
+   */
+  getAllIncludePaths(): Array<{
+    projectId: ProjectId$1;
+    includePath: URI;
+    includeConfig: IncludeConfig;
+  }>;
+  /**
+   * Register a listener to be called when the projects configuration has changed.
+   * @returns A disposable that can be used to unregister the callback.
+   */
+  onProjectsUpdate(callback: () => void): Disposable;
+  private getWorkspaceFolder;
+  private notifyListeners;
+  private updateIncludesExcludes;
+  private warnIfConfigOverride;
+}
+//#endregion
+//#region src/filesystem/types.d.ts
+interface FileNode extends FileSystemNode {
+  readonly isFile: true;
+  readonly isDirectory: false;
 }
-type ParsedAstDeployment = Simplify<MergeExclusive<ParsedAstDeployment.Node, ParsedAstDeployment.Instance>>;
-declare namespace ParsedAstDeployment {
-  type Node = c4.DeploymentNode;
-  type Instance = Omit<c4.DeployedInstance, 'element'> & {
-    readonly element: c4.FqnRef.ModelRef;
-  };
+interface FileSystemProvider$1 extends FileSystemProvider {
+  /**
+   * Scans the project files for the given URI.
+   * @returns The list of file system entries that are contained within the specified directory.
+   */
+  scanProjectFiles(folderUri: URI): Promise<FileNode[]>;
+  /**
+   * Loads the project config from the given file.
+   * @returns The project config.
+   * @throws Error if the file does not exist or is not a valid project config.
+   */
+  loadProjectConfig(filepath: URI): Promise<LikeC4ProjectConfig>;
+  /**
+   * Reads the directory and returns LikeC4 files.
+   *
+   * @param options.recursive If true, recursively reads the directory,
+   * @param options.maxDepth Maximum depth to traverse when recursive is true (default: Infinity)
+   */
+  readDirectory(uri: URI, options?: {
+    recursive?: boolean;
+    maxDepth?: number;
+  }): Promise<FileNode[]>;
+  /**
+   * Finds all files in the given directory, matching the given filter.
+   */
+  scanDirectory(directory: URI, filter: (filepath: string, isDirectory: boolean) => boolean): Promise<FileNode[]>;
+  /**
+   * Writes the content to the file system.
+   * Used by manual layouts.
+   */
+  writeFile(uri: URI, content: string): Promise<void>;
+  /**
+   * Deletes the file from the file system.
+   * Used by manual layouts.
+   * @return true if the file was deleted, false if the file did not exist.
+   */
+  deleteFile(uri: URI): Promise<boolean>;
 }
-type ParsedAstDeploymentRelation = c4.DeploymentRelationship & {
-  astPath: string;
-};
-type ParsedAstGlobals = Writable<c4.ModelGlobals>;
-interface ParsedAstElementView {
-  id: c4.ViewId;
-  viewOf?: c4.Fqn;
-  extends?: c4.ViewId;
-  astPath: string;
-  title: string | null;
-  description: c4.MarkdownOrString | null;
-  tags: c4.NonEmptyArray<c4.Tag> | null;
-  links: c4.NonEmptyArray<c4.Link> | null;
-  rules: c4.ElementViewRule[];
+interface FileSystemModuleContext extends FileSystemWatcherModuleContext {
+  fileSystemProvider: () => FileSystemProvider$1;
 }
-interface ParsedAstDynamicView {
-  id: c4.ViewId;
-  astPath: string;
-  title: string | null;
-  description: c4.MarkdownOrString | null;
-  tags: c4.NonEmptyArray<c4.Tag> | null;
-  links: c4.NonEmptyArray<c4.Link> | null;
-  steps: c4.DynamicViewStep[];
-  rules: Array<c4.DynamicViewRule>;
-  variant: c4.DynamicViewDisplayVariant | undefined;
+interface FileSystemWatcherModuleContext {
+  fileSystemWatcher: (services: LikeC4SharedServices) => FileSystemWatcher;
 }
-interface ParsedAstDeploymentView {
-  id: c4.ViewId;
-  astPath: string;
-  title: string | null;
-  description: c4.MarkdownOrString | null;
-  tags: c4.NonEmptyArray<c4.Tag> | null;
-  links: c4.NonEmptyArray<c4.Link> | null;
-  rules: Array<c4.DeploymentViewRule>;
+interface FileSystemWatcher extends AsyncDisposable {
+  /**
+   * Watches a folder for changes and triggers a reload of the documents and projects.
+   */
+  watch(folder: string): void;
 }
-type ParsedAstView = ParsedAstElementView | ParsedAstDynamicView | ParsedAstDeploymentView;
-interface AstNodeDescriptionWithFqn extends AstNodeDescription {
-  likec4ProjectId: c4.ProjectId;
-  id: c4.Fqn;
+interface LikeC4ManualLayoutsModuleContext {
+  manualLayouts: (services: LikeC4SharedServices) => LikeC4ManualLayouts;
 }
-type LikeC4AstNode = ValueOf<ConditionalPick<LikeC4AstType, AstNode>>;
-type LikeC4DocumentDiagnostic = Diagnostic & DiagnosticInfo<LikeC4AstNode>;
-interface LikeC4DocumentProps {
-  diagnostics?: Array<LikeC4DocumentDiagnostic>;
-  c4Specification?: ParsedAstSpecification;
-  c4Elements?: ParsedAstElement[];
-  c4ExtendElements?: ParsedAstExtend[];
-  c4ExtendDeployments?: ParsedAstExtend[];
-  c4ExtendRelations?: ParsedAstExtendRelation[];
-  c4Relations?: ParsedAstRelation[];
-  c4Globals?: ParsedAstGlobals;
-  c4Views?: ParsedAstView[];
-  c4Deployments?: ParsedAstDeployment[];
-  c4DeploymentRelations?: ParsedAstDeploymentRelation[];
-  c4Imports?: MultiMap<c4.ProjectId, c4.Fqn, Set<c4.Fqn>>;
+type ManualLayoutsSnapshot = {
+  hash: string;
+  views: Record<ViewId$1, LayoutedView$1>;
+};
+type ManualLayoutUpdateEvent = {
+  updated: URI;
+  projectId: ProjectId$1;
+  viewId: ViewId$1;
+} | {
+  removed: URI;
+  projectId: ProjectId$1;
+  /**
+   * Missing if triggered by FS event (file was deleted)
+   */
+  viewId?: ViewId$1;
+};
+type ManualLayoutUpdateListener = (event: ManualLayoutUpdateEvent) => void;
+interface LikeC4ManualLayouts extends Disposable {
+  /**
+   * 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>;
+  read(project: Project): Promise<ManualLayoutsSnapshot | null>;
+  write(project: Project, layouted: LayoutedView$1): Promise<Location>;
+  remove(project: Project, view: ViewId$1): Promise<Location | null>;
+  clearCaches(): void;
+  /**
+   * Registers a listener for manual layout updates.
+   * The listener will be called when a manual layout is created, updated, or deleted.
+   */
+  onManualLayoutUpdate(listener: ManualLayoutUpdateListener): Disposable;
+  /**
+   * Handles file system updates for manual layouts.
+   * Used by the file system watcher to notify the manual layouts module of changes.
+   * @param event The file system event
+   */
+  handleFileSystemUpdate(event: {
+    update: URI;
+    delete?: never;
+  } | {
+    delete: URI;
+    update?: never;
+  }): Promise<void>;
 }
-type LikeC4GrammarDocument = Omit<LangiumDocument<LikeC4Grammar>, 'diagnostics'>;
-interface LikeC4LangiumDocument extends LikeC4GrammarDocument, LikeC4DocumentProps {
-  likec4ProjectId: c4.ProjectId;
+//#endregion
+//#region src/filesystem/noop.d.ts
+declare const NoFileSystemWatcher: FileSystemWatcherModuleContext;
+declare const NoFileSystem: FileSystemModuleContext;
+declare const NoLikeC4ManualLayouts: LikeC4ManualLayoutsModuleContext;
+//#endregion
+//#region src/filesystem/LikeC4FileSystem.d.ts
+declare const WithFileSystem: (enableWatcher?: boolean) => FileSystemModuleContext;
+//#endregion
+//#region src/filesystem/ChokidarWatcher.d.ts
+declare const WithChokidarWatcher: FileSystemWatcherModuleContext;
+//#endregion
+//#region src/filesystem/LikeC4ManualLayouts.d.ts
+declare const WithLikeC4ManualLayouts: LikeC4ManualLayoutsModuleContext;
+//#endregion
+//#region src/formatting/LikeC4Formatter.d.ts
+type QuoteStyle = 'single' | 'double' | 'ignore' | 'auto';
+interface LikeC4FormatterOptions {
+  quoteStyle: QuoteStyle;
 }
-interface ParsedLikeC4LangiumDocument extends LikeC4GrammarDocument, Required<LikeC4DocumentProps> {
-  likec4ProjectId: c4.ProjectId;
+type ExtendedFormattingCommandType = 'normalizeQuotes';
+interface ExtendedFormattingCommand {
+  type: ExtendedFormattingCommandType;
+  region: FormattingRegion;
+}
+declare class LikeC4Formatter extends AbstractFormatter {
+  protected options: LikeC4FormatterOptions;
+  extendedFormattingCommands: ExtendedFormattingCommand[];
+  constructor(services: LikeC4Services);
+  protected doDocumentFormat(document: LangiumDocument, options: FormattingOptions, range?: Range): TextEdit[];
+  protected format(node: AstNode): void;
+  protected formatTags(node: AstNode): void;
+  protected formatDeploymentRelation(node: AstNode): void;
+  protected formatExtendDeployment(node: AstNode): void;
+  protected formatRelation(node: AstNode): void;
+  protected removeIndentFromTopLevelStatements(node: AstNode): void;
+  protected indentContentInBraces(node: AstNode): void;
+  protected appendKeywordsWithSpace(node: AstNode): void;
+  protected formatView(node: AstNode): void;
+  protected formatLeafProperty(node: AstNode): void;
+  protected formatLinkProperty(node: AstNode): void;
+  protected formatNavigateToProperty(node: AstNode): void;
+  protected formatAutolayoutProperty(node: AstNode): void;
+  protected formatMetadataProperty(node: AstNode): void;
+  protected formatElementDeclaration(node: AstNode): void;
+  protected formatExtendElement(node: AstNode): void;
+  protected formatGlobals(node: AstNode): void;
+  protected formatImports(node: AstNode): void;
+  protected formatSpecificationRule(node: AstNode): void;
+  protected formatWithPredicate(node: AstNode): void;
+  protected formatDeploymentNodeDeclaration(node: AstNode): void;
+  protected formatDeployedInstance(node: AstNode): void;
+  protected formatViewRuleGlobalStyle(node: AstNode): void;
+  protected formatViewRuleGlobalPredicate(node: AstNode): void;
+  protected formatViewRuleGroup(node: AstNode): void;
+  protected formatViewRuleStyle(node: AstNode): void;
+  protected formatWhereExpression(node: AstNode): void;
+  protected formatWhereRelationExpression(node: AstNode): void;
+  protected formatWhereElementExpression(node: AstNode): void;
+  protected formatIncludeExcludeExpressions(node: AstNode): void;
+  protected formatRelationExpression(node: AstNode): void;
+  private findPredicateExpressionRoot;
+  private on;
+  private doExtendedFormatting;
+  protected normalizeQuotes(node: AstNode): void;
+  private quotesNormalizerFactory;
+  private escapeQuotesInternalQuotes;
+  private getAutoQuoteStyle;
+  private onConfigurationUpdate;
 }
 //#endregion
 //#region src/references/name-provider.d.ts
@@ -1997,15 +2006,6 @@ declare class LikeC4ScopeProvider extends DefaultScopeProvider {
   protected getGlobalScope(referenceType: string, context: ReferenceInfo): Scope;
 }
 //#endregion
-//#region src/utils/disposable.d.ts
-declare abstract class ADisposable implements Disposable {
-  protected toDispose: Disposable[];
-  protected isDisposed: boolean;
-  onDispose(...disposable: Disposable[]): void;
-  dispose(): void;
-  protected throwIfDisposed(): void;
-}
-//#endregion
 //#region src/model/fqn-index.d.ts
 declare class FqnIndex<AstNd = Element> extends ADisposable {
   protected services: LikeC4Services;
@@ -2142,7 +2142,7 @@ declare class MergedSpecification {
  * Provides access to "last seen artifacts" for a given project,
  * (Results of the last successful parsing)
  */
-declare class LastSeenArtifacts {
+declare class LastSeenArtifacts extends ADisposable {
   #private;
   constructor(services: LikeC4Services);
   /**
@@ -2280,7 +2280,7 @@ type LayoutViewParams = {
   cancelToken?: CancellationToken | undefined; /** Optional AI-generated layout hints */
   layoutHints?: AILayoutHints | undefined;
 };
-interface LikeC4Views {
+interface LikeC4Views extends Disposable {
   readonly layouter: GraphvizLayouter;
   /**
    * Returns computed views (i.e. views with predicates computed)
@@ -3147,7 +3147,7 @@ declare const DocumentParserFromMixins: {
   };
 } & typeof BaseParser;
 declare class DocumentParser extends DocumentParserFromMixins {}
-declare class LikeC4ModelParser {
+declare class LikeC4ModelParser extends ADisposable {
   private services;
   protected cachedParsers: any;
   constructor(services: LikeC4Services);