utils.ts

/*
* utils.ts
*
* Copyright (C) 2020-2022 Posit Software, PBC
*
*/

import { basename, dirname, extname, join, relative } from "../src/deno_ral/path.ts";
import { parseFormatString } from "../src/core/pandoc/pandoc-formats.ts";
import { kMetadataFormat, kOutputExt, kOutputFile } from "../src/config/constants.ts";
import { pathWithForwardSlashes, safeExistsSync } from "../src/core/path.ts";
import { readYaml } from "../src/core/yaml.ts";
import { isWindows } from "../src/deno_ral/platform.ts";
import { bookOutputStem } from "../src/project/types/book/book-shared.ts";
import { ProjectConfig } from "../src/project/types.ts";

// caller is responsible for cleanup!
export function inTempDirectory(fn: (dir: string) => unknown): unknown {
  const dir = Deno.makeTempDirSync();
  return fn(dir);
}

// Find a _quarto.yaml file in the directory hierarchy of the input file
export function findProjectDir(input: string, until?: RegExp | undefined): string | undefined {
  let dir = dirname(input);
  // This is used for smoke-all tests and should stop there 
  // to avoid side effect of _quarto.yml outside of Quarto tests folders
  while (dir !== "" && dir !== "." && (until ? !until.test(pathWithForwardSlashes(dir)) : true)) {
    const filename = ["_quarto.yml", "_quarto.yaml"].find((file) => {
      const yamlPath = join(dir, file);
      if (safeExistsSync(yamlPath)) {
        return true;
      }
    });
    if (filename) {
      return dir;
    }

    const newDir = dirname(dir); // stops at the root for both Windows and Posix
    if (newDir === dir) {
      return;
    }
    dir = newDir;
  }
}

export function findProjectOutputDir(projectdir: string | undefined) {
  if (!projectdir) {
    return;
  }
  const yaml = readYaml(join(projectdir, "_quarto.yml"));
  let type = undefined;
  try {
    // deno-lint-ignore no-explicit-any
    type = ((yaml as any).project as any).type;
  } catch (error) {
    throw new Error("Failed to read quarto project YAML" + String(error));
  }
  if (type === "book") {
    return "_book";
  }
  if (type === "website") {
    return (yaml as any)?.project?.["output-dir"] || "_site";
  }
  if (type === "manuscript") {
    return (yaml as any)?.project?.["output-dir"] || "_manuscript";
  }
  // type default explicit or just unset
  return (yaml as any)?.project?.["output-dir"] || "";
}

// Get the book output stem using the real bookOutputStem() from book-shared.ts
export function findBookOutputStem(projectdir: string | undefined): string | undefined {
  if (!projectdir) {
    return undefined;
  }
  const yaml = readYaml(join(projectdir, "_quarto.yml")) as Record<string, unknown>;
  // deno-lint-ignore no-explicit-any
  const projectType = ((yaml as any).project as any)?.type;
  if (projectType !== "book") {
    return undefined;
  }
  // Pass the yaml as ProjectConfig - it has { project: {...}, book: {...} }
  return bookOutputStem(projectdir, yaml as ProjectConfig);
}

// Gets output that should be created for this input file and target format
export function outputForInput(
  input: string,
  to: string,
  projectOutDir?: string,
  projectRoot?: string,
  // deno-lint-ignore no-explicit-any
  metadata?: Record<string, any>,
) {
  // TODO: Consider improving this (e.g. for cases like Beamer, or typst)
  projectRoot = projectRoot ?? findProjectDir(input);
  projectOutDir = projectOutDir ?? findProjectOutputDir(projectRoot);

  // For book projects with single-file output (PDF, Typst, EPUB), use the book title as stem
  // Multi-file formats (HTML) produce individual chapter files, so use input filename
  // Single-file formats only produce merged output when rendering the index file
  const inputBasename = basename(input, extname(input));
  const isMultiFileFormat = to.startsWith("html") || to === "revealjs";
  const isSingleFileBookRender = !isMultiFileFormat && inputBasename === "index";
  const bookStem = isSingleFileBookRender ? findBookOutputStem(projectRoot) : undefined;
  const dir = bookStem ? "" : (projectRoot ? relative(projectRoot, dirname(input)) : dirname(input));
  let stem = bookStem || metadata?.[kMetadataFormat]?.[to]?.[kOutputFile] || inputBasename;
  let ext = metadata?.[kMetadataFormat]?.[to]?.[kOutputExt];

  // TODO: there's a bug where output-ext keys from a custom format are 
  // not recognized (specifically this happens for confluence)
  //
  // we hack it here for the time being.
  //
  if (to === "confluence-publish") {
    ext = "xml";
  }
  if (to === "docusaurus-md") {
    ext = "mdx";
  }

  
  const formatDesc = parseFormatString(to);
  const baseFormat = formatDesc.baseFormat;
  if (formatDesc.baseFormat === "pdf") {
    stem = `${stem}${formatDesc.variants.join("")}${
      formatDesc.modifiers.join("")
    }`;
  }

  let outputExt;
  if (ext) { 
    outputExt = ext 
  } else {
    outputExt = baseFormat || "html";
    if (baseFormat === "latex" || baseFormat == "context") {
      outputExt = "tex";
    }
    if (baseFormat === "beamer") {
      outputExt = "pdf";
    }
    if (baseFormat === "revealjs") {
      outputExt = "html";
    }
    if (["commonmark", "gfm", "markdown", "markdown_strict"].some((f) => f === baseFormat)) {
      outputExt = "md";
    }
    if (baseFormat === "csljson") {
      outputExt = "csl";
    }
    if (baseFormat === "bibtex" || baseFormat === "biblatex") {
      outputExt = "bib";
    }
    if (baseFormat === "jats") {
      outputExt = "xml";
    }
    if (baseFormat === "asciidoc") {
      outputExt = "adoc";
    }
    if (baseFormat === "typst") {
      outputExt = "pdf";
    }
    if (baseFormat === "dashboard") {
      outputExt = "html";
    }
    if (baseFormat === "email") {
      outputExt = "html";
    }
  }

  const outputPath: string = projectRoot && projectOutDir !== undefined
      ? join(projectRoot, projectOutDir, dir, `${stem}.${outputExt}`)
      : projectOutDir !== undefined
      ? join(projectOutDir, dir, `${stem}.${outputExt}`)
      : join(dir, `${stem}.${outputExt}`);
  const supportPath: string = projectRoot && projectOutDir !== undefined
    ? join(projectRoot, projectOutDir, dir, `${stem}_files`)
    : projectOutDir !== undefined
    ? join(projectOutDir, dir, `${stem}_files`)
    : join(dir, `${stem}_files`);

  // For book projects with typst format, the intermediate .typ file is at project root
  // as index.typ (from the merged book content), not derived from the PDF path
  let intermediateTypstPath: string | undefined;
  if (baseFormat === "typst" && projectRoot && projectOutDir === "_book") {
    // Book projects place the merged .typ at project root as index.typ
    intermediateTypstPath = join(projectRoot, "index.typ");
  }

  return {
    outputPath,
    supportPath,
    intermediateTypstPath,
  };
}

export function projectOutputForInput(input: string) {
  const projectDir = findProjectDir(input);
  const projectOutDir = findProjectOutputDir(projectDir);
  if (!projectDir) {
    throw new Error("No project directory found");
  }
  const dir = join(projectDir, projectOutDir, relative(projectDir, dirname(input)));
  const stem = basename(input, extname(input));

  const outputPath = join(dir, `${stem}.html`);
  const supportPath = join(dir, `site_libs`);

  return {
    outputPath,
    supportPath,
  };
}

export function docs(path: string): string {
  return join("docs", path);
}

export function fileLoader(...path: string[]) {
  return (file: string, to: string) => {
    const input = docs(join(...path, file));
    const output = outputForInput(input, to);
    return {
      input,
      output,
    };
  };
}

// On Windows, `quarto.cmd` needs to be explicit in `execProcess()`
export function quartoDevCmd(): string {
  return isWindows ? "quarto.cmd" : "quarto";
}