@likec4/language-server 1.56.0 → 1.58.0

package/dist/_chunks/module.d.mts

@@ -18,6 +18,7 @@ import { Fqn as Fqn$1, GuardedBy, LayoutedView as LayoutedView$1, ProjectId as P
 import { CancellationToken as CancellationToken$1 } from "vscode-jsonrpc";
 import * as type_fest0 from "type-fest";
 import { ConditionalPick, MergeExclusive, Simplify, Tagged, ValueOf, Writable } from "type-fest";
+import { AILayoutHints } from "@likec4/layouts/ai";
 
 //#region src/documentation/documentation-provider.d.ts
 /**
@@ -40,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
@@ -383,7 +62,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;
@@ -515,7 +194,7 @@ declare const CustomElementProperties = "CustomElementProperties";
 interface CustomRelationProperties extends langium.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 langium.AstNode {
@@ -653,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 {
@@ -994,7 +673,7 @@ interface MetadataAttribute extends langium.AstNode {
   readonly $container: MetadataBody;
   readonly $type: 'MetadataAttribute';
   boolValue: boolean;
-  key: string;
+  key: Id;
   value?: MetadataValue;
 }
 declare const MetadataAttribute = "MetadataAttribute";
@@ -1028,7 +707,7 @@ interface ModelViews extends langium.AstNode {
 }
 declare const ModelViews = "ModelViews";
 interface MultipleProperty extends langium.AstNode {
-  readonly $container: CustomElementProperties | DeploymentViewRuleStyle | ElementStyleProperty | GlobalStyle | ViewRuleStyle;
+  readonly $container: CustomElementProperties | CustomRelationProperties | DeploymentViewRuleStyle | ElementStyleProperty | GlobalStyle | SpecificationRelationshipKind | ViewRuleStyle;
   readonly $type: 'MultipleProperty';
   key: 'multiple';
   value: boolean;
@@ -1203,7 +882,7 @@ interface SpecificationRelationshipKind extends langium.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 langium.AstNode {
@@ -1277,6 +956,13 @@ interface ViewRef extends langium.AstNode {
   view: langium.Reference<LikeC4View>;
 }
 declare const ViewRef = "ViewRef";
+interface ViewRuleAncestors extends langium.AstNode {
+  readonly $container: DeploymentViewBody;
+  readonly $type: 'ViewRuleAncestors';
+  key: 'includeAncestors';
+  value: boolean;
+}
+declare const ViewRuleAncestors = "ViewRuleAncestors";
 interface ViewRuleAutoLayout extends langium.AstNode {
   readonly $container: DeploymentViewBody | DynamicViewBody | ElementViewBody;
   readonly $type: 'ViewRuleAutoLayout';
@@ -1594,6 +1280,7 @@ type LikeC4AstType = {
   ViewProperty: ViewProperty;
   ViewRef: ViewRef;
   ViewRule: ViewRule;
+  ViewRuleAncestors: ViewRuleAncestors;
   ViewRuleAutoLayout: ViewRuleAutoLayout;
   ViewRuleGlobalPredicateRef: ViewRuleGlobalPredicateRef;
   ViewRuleGlobalStyle: ViewRuleGlobalStyle;
@@ -1703,6 +1390,7 @@ interface ParsedAstSpecification {
     line?: c4.RelationshipLineType;
     head?: c4.RelationshipArrowType;
     tail?: c4.RelationshipArrowType;
+    multiple?: boolean;
   }>;
   colors: Record<c4.CustomColor, {
     color: c4.ColorLiteral;
@@ -1742,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
@@ -1987,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;
@@ -2132,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);
   /**
@@ -2267,9 +2277,10 @@ type LayoutViewParams = {
    */
   layoutType?: LayoutType | undefined;
   projectId?: ProjectId | undefined;
-  cancelToken?: CancellationToken | undefined;
+  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)
@@ -2285,10 +2296,12 @@ interface LikeC4Views {
   layoutAllViews(projectId?: ProjectId | undefined, cancelToken?: CancellationToken): 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>;
@@ -3134,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);
@@ -3160,7 +3173,7 @@ 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[];
@@ -3319,7 +3332,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[];
@@ -3538,4 +3551,4 @@ declare function createLanguageServices<I1, I2, I3, I extends I1 & I2 & I3 & Lik
  */
 declare function createSharedServices(context?: Partial<LanguageServicesContext>): LikeC4SharedServices;
 //#endregion
-export { NoFileSystem as A, ManualLayoutsSnapshot as B, LikeC4ModelBuilder as C, WithLikeC4ManualLayouts as D, LangiumDocuments as E, FileSystemProvider$1 as F, ProjectData as H, FileSystemWatcher as I, FileSystemWatcherModuleContext as L, NoLikeC4ManualLayouts as M, FileNode as N, WithChokidarWatcher as O, FileSystemModuleContext as P, LikeC4ManualLayouts as R, ViewLocateResult as S, LikeC4WorkspaceManager as T, ProjectsManager as U, Project as V, LikeC4ViewsModuleContext as _, LikeC4SharedModuleContext as a, LikeC4Views as b, createLikeC4Module as c, LikeC4LanguageServices as d, DocumentParser as f, configureLanguageServerLogger as g, ConfigureLanguageServerLoggerOptions as h, LikeC4ServicesContext as i, NoFileSystemWatcher as j, WithFileSystem as k, createSharedServices as l, startLanguageServer$1 as m, LikeC4AddedServices as n, LikeC4SharedServices as o, LikeC4ModelParser as p, LikeC4Services as r, createLanguageServices as s, LanguageServicesContext as t, FormatOptions as u, WithGraphviz as v, FqnIndex as w, LikeC4ModelLocator as x, WithWasmGraphviz as y, LikeC4ManualLayoutsModuleContext as z };
+export { WithFileSystem as A, LikeC4ManualLayoutsModuleContext as B, ViewLocateResult as C, LangiumDocuments as D, LikeC4WorkspaceManager as E, FileSystemModuleContext as F, Project as H, FileSystemProvider$1 as I, FileSystemWatcher as L, NoFileSystemWatcher as M, NoLikeC4ManualLayouts as N, WithLikeC4ManualLayouts as O, FileNode as P, FileSystemWatcherModuleContext as R, LikeC4ModelLocator as S, FqnIndex as T, ProjectData as U, ManualLayoutsSnapshot as V, ProjectsManager as W, LikeC4ViewsModuleContext as _, LikeC4SharedModuleContext as a, LayoutViewParams as b, createLikeC4Module as c, LikeC4LanguageServices as d, DocumentParser as f, configureLanguageServerLogger as g, ConfigureLanguageServerLoggerOptions as h, LikeC4ServicesContext as i, NoFileSystem as j, WithChokidarWatcher as k, createSharedServices as l, startLanguageServer$1 as m, LikeC4AddedServices as n, LikeC4SharedServices as o, LikeC4ModelParser as p, LikeC4Services as r, createLanguageServices as s, LanguageServicesContext as t, FormatOptions as u, WithGraphviz as v, LikeC4ModelBuilder as w, LikeC4Views as x, WithWasmGraphviz as y, LikeC4ManualLayouts as z };