claude: knitr as discovery engine

Author: gordonwoodhull

packages/quarto-types/src/quarto-api.ts

@@ -78,6 +78,18 @@ export interface PreviewServer {
   stop: () => Promise<void>;
 }
 
+/**
+ * Temporary context for managing temporary files and directories
+ */
+export interface TempContext {
+  /** Create a temporary directory and return its path */
+  createDir: () => string;
+  /** Clean up all temporary resources */
+  cleanup: () => void;
+  /** Register a cleanup handler */
+  onCleanup: (handler: VoidFunction) => void;
+}
+
 /**
  * Global Quarto API interface
  */
@@ -600,6 +612,13 @@ export interface QuartoAPI {
      * @param handler - Function to run on cleanup (can be async)
      */
     onCleanup: (handler: () => void | Promise<void>) => void;
+
+    /**
+     * Get global temporary context for managing temporary files and directories
+     *
+     * @returns Global TempContext instance
+     */
+    tempContext: () => TempContext;
   };
 
   /**
@@ -659,6 +678,28 @@ export interface QuartoAPI {
      * @param options - Post-processing options including output path and preserve map
      */
     postProcessRestorePreservedHtml: (options: PostProcessOptions) => void;
+
+    /**
+     * Convert line/column position to character index
+     *
+     * @param text - Text to search in
+     * @returns Function that converts position to index
+     */
+    lineColToIndex: (
+      text: string,
+    ) => (position: { line: number; column: number }) => number;
+
+    /**
+     * Create a handler for executing inline code
+     *
+     * @param language - Programming language identifier
+     * @param exec - Function to execute code expression
+     * @returns Handler function that processes code strings
+     */
+    executeInlineCodeHandler: (
+      language: string,
+      exec: (expr: string) => string | undefined,
+    ) => (code: string) => string;
   };
 
   /**

src/core/quarto-api.ts

@@ -66,6 +66,11 @@ import {
  */
 export type { PreviewServer };
 
+/**
+ * Temporary context for managing temporary files and directories
+ */
+export type { TempContext };
+
 /**
  * Global Quarto API interface
  */
@@ -232,6 +237,7 @@ export interface QuartoAPI {
       cwd?: string;
     }) => PreviewServer;
     onCleanup: (handler: () => void | Promise<void>) => void;
+    tempContext: () => TempContext;
   };
 
   /**
@@ -249,6 +255,11 @@ export interface QuartoAPI {
     lines: (text: string) => string[];
     trimEmptyLines: (lines: string[], trim?: "leading" | "trailing" | "all") => string[];
     postProcessRestorePreservedHtml: (options: PostProcessOptions) => void;
+    lineColToIndex: (text: string) => (position: { line: number; column: number }) => number;
+    executeInlineCodeHandler: (
+      language: string,
+      exec: (expr: string) => string | undefined
+    ) => (code: string) => string;
   };
 
   /**
@@ -294,8 +305,11 @@ import type { ProcessResult } from "../core/process-types.ts";
 import { asYamlText } from "../core/jupyter/jupyter-fixups.ts";
 import { breakQuartoMd } from "../core/lib/break-quarto-md.ts";
 import type { QuartoMdChunks, QuartoMdCell } from "../core/lib/break-quarto-md.ts";
-import { lines, trimEmptyLines } from "../core/lib/text.ts";
+import { lines, trimEmptyLines, lineColToIndex } from "../core/lib/text.ts";
 import { md5HashSync } from "../core/hash.ts";
+import { executeInlineCodeHandler } from "../core/execute-inline.ts";
+import { globalTempContext } from "../core/temp.ts";
+import type { TempContext } from "../core/temp-types.ts";
 
 /**
  * Global Quarto API implementation
@@ -393,6 +407,7 @@ export const quartoAPI: QuartoAPI = {
     execProcess,
     runExternalPreviewServer,
     onCleanup,
+    tempContext: globalTempContext,
   },
 
   markdown: {
@@ -404,6 +419,8 @@ export const quartoAPI: QuartoAPI = {
     lines,
     trimEmptyLines,
     postProcessRestorePreservedHtml,
+    lineColToIndex,
+    executeInlineCodeHandler,
   },
 
   crypto: {

src/execute/engine.ts

@@ -17,7 +17,7 @@ import { dirAndStem } from "../core/path.ts";
 import { metadataAsFormat } from "../config/metadata.ts";
 import { kBaseFormat, kEngine } from "../config/constants.ts";
 
-import { knitrEngine } from "./rmd.ts";
+import { knitrEngineDiscovery } from "./rmd.ts";
 import { jupyterEngineDiscovery } from "./jupyter/jupyter.ts";
 import { ExternalEngine } from "../resources/types/schema-types.ts";
 import { kMdExtensions, markdownEngineDiscovery } from "./markdown.ts";
@@ -52,8 +52,8 @@ export function executionEngine(name: string) {
   return kEngines.get(name);
 }
 
-// Register the standard engines
-registerExecutionEngine(knitrEngine);
+// Register the standard engines with discovery interface
+registerExecutionEngine(knitrEngineDiscovery as unknown as ExecutionEngine);
 
 // Register jupyter engine with discovery interface
 registerExecutionEngine(jupyterEngineDiscovery as unknown as ExecutionEngine);