Method formatDocument

src/cm/lsp/clientManager.ts:388–455

(
    metadata: FileMetadata,
    options: FormattingOptions = {},
  )

  }

  async formatDocument(
    metadata: FileMetadata,
    options: FormattingOptions = {},
  ): Promise<boolean> {
    const { uri: originalUri, languageId, languageName, view, file } = metadata;

    const effectiveLang = safeString(languageId ?? languageName).toLowerCase();
    if (!effectiveLang || !view) return false;

    const servers = serverRegistry.getServersForLanguage(effectiveLang);
    if (!servers.length) return false;

    for (const server of servers) {
      if (isSettingsOrKeybindingsFile(server, originalUri, file)) {
        continue;
      }
      if (!supportsBuiltinFormatting(server)) continue;
      try {
        const target = await this.#resolveRuntimeTarget(server, {
          uri: originalUri,
          file,
          view,
          languageId: effectiveLang,
          rootUri: metadata.rootUri,
        });
        if (!target) {
          console.warn(
            `Cannot resolve document URI for formatting with ${server.id}: ${originalUri}`,
          );
          continue;
        }
        const normalizedUri = target.documentUri;
        const context: RootUriContext = {
          uri: normalizedUri,
          languageId: effectiveLang,
          view,
          file,
          rootUri: target.normalizedRootUri ?? undefined,
        };
        const state = await this.#ensureClient(server, context, target);
        const capabilities = state.client.serverCapabilities;
        if (!capabilities?.documentFormattingProvider) continue;
        state.attach(normalizedUri, view);
        const plugin = LSPPlugin.get(view);
        if (!plugin) continue;
        plugin.client.sync();
        const edits = await state.client.request<
          { textDocument: { uri: string }; options: FormattingOptions },
          TextEdit[] | null
        >("textDocument/formatting", {
          textDocument: { uri: normalizedUri },
          options: buildFormattingOptions(view, options),
        });
        if (!edits || !edits.length) {
          plugin.client.sync();
          return true;
        }
        const applied = applyTextEdits(plugin, view, edits);