dev-call make-ast-diagram

Author: cscheid

src/command/dev-call/cmd.ts

@@ -4,6 +4,7 @@ import { commands } from "../command.ts";
 import { buildJsCommand } from "./build-artifacts/cmd.ts";
 import { validateYamlCommand } from "./validate-yaml/cmd.ts";
 import { showAstTraceCommand } from "./show-ast-trace/cmd.ts";
+import { makeAstDiagramCommand } from "./make-ast-diagram/cmd.ts";
 
 type CommandOptionInfo = {
   name: string;
@@ -73,4 +74,5 @@ export const devCallCommand = new Command()
   .command("cli-info", generateCliInfoCommand)
   .command("validate-yaml", validateYamlCommand)
   .command("build-artifacts", buildJsCommand)
-  .command("show-ast-trace", showAstTraceCommand);
+  .command("show-ast-trace", showAstTraceCommand)
+  .command("make-ast-diagram", makeAstDiagramCommand);

src/command/dev-call/make-ast-diagram/cmd.ts

@@ -0,0 +1,32 @@
+/*
+ * cmd.ts
+ *
+ * Copyright (C) 2025 Posit Software, PBC
+ */
+
+import { Command } from "cliffy/command/mod.ts";
+import { join } from "../../../deno_ral/path.ts";
+import { resourcePath } from "../../../core/resources.ts";
+import { execProcess } from "../../../core/process.ts";
+
+export const makeAstDiagramCommand = new Command()
+  .name("make-ast-diagram")
+  .hidden()
+  .arguments("<arguments...>")
+  .description(
+    "Creates a diagram of the Pandoc AST.\n\n",
+  )
+  .action(async (_options: unknown, ...args: string[]) => {
+    const renderOpts = {
+      cmd: Deno.execPath(),
+      args: [
+        "run",
+        "--allow-read",
+        "--allow-write",
+        "--allow-run",
+        resourcePath(join("tools", "ast-diagram", "main.ts")),
+        ...args,
+      ],
+    };
+    await execProcess(renderOpts);
+  });

src/resources/tools/ast-diagram/README.md

@@ -0,0 +1,3 @@
+This is currently copied over from https://github.com/cscheid/pandoc-ast-block-diagram
+
+Ideally that becomes a whole set of NPM packages, and we then import from that directly.