Function openFileModal

website/src/scripts/modal.ts:901–1020

(
  filePath: string,
  type: string,
  updateUrl = true,
  trigger?: HTMLElement
)

 * @param trigger - The element that triggered the modal (for focus return)
 */
export async function openFileModal(
  filePath: string,
  type: string,
  updateUrl = true,
  trigger?: HTMLElement
): Promise<void> {
  const modal = document.getElementById("file-modal");
  const title = document.getElementById("modal-title");
  const installDropdown = document.getElementById("install-dropdown");
  const installBtnMain = document.getElementById(
    "install-btn-main"
  ) as HTMLAnchorElement | null;
  const installVscode = document.getElementById(
    "install-vscode"
  ) as HTMLAnchorElement | null;
  const installInsiders = document.getElementById(
    "install-insiders"
  ) as HTMLAnchorElement | null;
  const copyBtn = document.getElementById("copy-btn");
  const installCommandBtn = document.getElementById("install-command-btn");
  const downloadBtn = document.getElementById("download-btn");
  const closeBtn = document.getElementById("close-modal");
  if (!modal || !title) return;

  modal.classList.remove("details-mode");

  currentFilePath = filePath;
  currentFileType = type;
  currentViewMode = "raw";

  // Track trigger element for focus return
  triggerElement =
    trigger || triggerElement || (document.activeElement as HTMLElement);

  // Update URL for deep linking
  if (updateUrl) {
    updateHash(filePath);
  }

  if (!originalDocumentTitle) {
    originalDocumentTitle = document.title;
  }

  // Show modal with loading state
  const fallbackName = getFileName(filePath);
  updateModalTitle(fallbackName, filePath);
  modal.classList.remove("hidden");
  modal.classList.add("visible");

  // Set focus to close button for accessibility
  setTimeout(() => {
    closeBtn?.focus();
  }, 0);

  // Handle plugins differently - show as item list
  if (type === "plugin") {
    const modalContent = getModalContent();
    if (!modalContent) return;