@travetto/doc 7.1.2 → 7.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@travetto/doc",
-  "version": "7.1.2",
+  "version": "7.1.3",
   "description": "Documentation support for the Travetto framework",
   "keywords": [
     "docs",
@@ -24,12 +24,12 @@
     "directory": "module/doc"
   },
   "dependencies": {
-    "@travetto/runtime": "^7.1.2",
+    "@travetto/runtime": "^7.1.3",
     "@types/prismjs": "^1.26.5",
     "prismjs": "^1.30.0"
   },
   "peerDependencies": {
-    "@travetto/cli": "^7.1.2"
+    "@travetto/cli": "^7.1.3"
   },
   "peerDependenciesMeta": {
     "@travetto/cli": {

package/src/jsx.ts

@@ -1,4 +1,5 @@
-import { castTo, TypedObject } from '@travetto/runtime';
+import { castTo, Runtime, TypedObject } from '@travetto/runtime';
+import { PackageUtil } from '@travetto/manifest';
 
 import type { LIBRARIES } from './mapping/library.ts';
 import type { MODULES } from './mapping/module.ts';
@@ -105,4 +106,7 @@ export const d = {
   field: (name: string) => createElement(c.Field, { name }),
   library: (name: keyof typeof LIBRARIES) => createElement(c.Library, { name }),
   module: (name: keyof typeof MODULES) => createElement(c.Module, { name }),
+  installCommand: (pkg: string, production?: boolean) => PackageUtil.getInstallCommand(Runtime, pkg, production),
+  workspaceInitCommand: () => PackageUtil.getWorkspaceInitCommand(Runtime),
+  get trv() { return PackageUtil.getPackageCommand(Runtime, 'trv'); },
 };

package/src/render/context.ts

@@ -3,7 +3,7 @@ import path from 'node:path';
 import { PackageUtil } from '@travetto/manifest';
 import { castTo, RuntimeIndex } from '@travetto/runtime';
 
-import { type JSXElementByFn, c } from '../jsx.ts';
+import { type JSXElementByFn, c, d } from '../jsx.ts';
 import { DocResolveUtil, type ResolvedCode, type ResolvedRef, type ResolvedSnippetLink } from '../util/resolve.ts';
 import { DocRunUtil } from '../util/run.ts';
 import { createElement, JSXRuntimeTag } from '../../support/jsx-runtime.ts';
@@ -56,7 +56,7 @@ export class RenderContext {
    * Get rebuilt comment
    */
   get rebuildStamp(): string {
-    return `Please modify ${this.file.replace(this.repoRoot, this.baseUrl)} and execute "npx trv doc" to rebuild`;
+    return `Please modify ${this.file.replace(this.repoRoot, this.baseUrl)} and execute "${d.trv} doc" to rebuild`;
   }
 
   /**

package/src/render/html.ts

@@ -52,11 +52,7 @@ export const Html: RenderProvider<RenderContext> = {
   },
   Install: async ({ context, node }) => {
     const highlighted = highlight(`
-npm install ${node.props.pkg}
-
-# or
-
-yarn add ${node.props.pkg}
+${PackageUtil.getInstallInstructions(node.props.pkg, true)}
 `, 'bash');
 
     return `\n

package/src/render/markdown.ts

@@ -55,11 +55,7 @@ export const Markdown: RenderProvider<RenderContext> = {
   Install: async ({ context, node }) =>
     `\n\n**Install: ${node.props.title}**
 \`\`\`bash
-npm install ${node.props.pkg}
-
-# or
-
-yarn add ${node.props.pkg}
+${PackageUtil.getInstallInstructions(node.props.pkg, true)}
 \`\`\`
 `,
   Code: async ({ context, node, props }) => {

package/src/util/run.ts

@@ -1,6 +1,6 @@
 import os from 'node:os';
 import util from 'node:util';
-import { spawn, type ChildProcess } from 'node:child_process';
+import { spawn } from 'node:child_process';
 import path from 'node:path';
 
 import { Env, ExecUtil, Runtime, RuntimeIndex } from '@travetto/runtime';
@@ -62,41 +62,37 @@ export class DocRunUtil {
       .replace(/\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}([.]\d{3})?Z?/g, this.#docState.getDate.bind(this.#docState))
       .replace(/\b[0-9a-f]{4}[0-9a-f\-]{8,40}\b/ig, this.#docState.getId.bind(this.#docState))
       .replace(/(\d+[.]\d+[.]\d+)-(alpha|rc)[.]\d+/g, (all, value) => value);
-    if (config.filter) {
-      text = text.split(/\n/g).filter(config.filter).join('\n');
-    }
-    if (config.rewrite) {
-      text = config.rewrite(text);
+    if (config.filter || config.rewrite) {
+      text = text.split(/\n/g)
+        .filter(line => config.filter?.(line) ?? true)
+        .map(line => config.rewrite?.(line) ?? line)
+        .join('\n');
     }
     return text;
   }
 
-  /**
-   * Spawn command with appropriate environment, and cwd
-   */
-  static spawn(cmd: string, args: string[], config: RunConfig = {}): ChildProcess {
-    return spawn(cmd, args, {
-      cwd: config.workingDirectory ?? this.workingDirectory(config),
-      env: {
-        ...process.env,
-        ...Env.DEBUG.export(false),
-        ...Env.TRV_CLI_IPC.export(undefined),
-        ...Env.TRV_MANIFEST.export(''),
-        ...Env.TRV_BUILD.export('none'),
-        ...Env.TRV_ROLE.export(undefined),
-        ...Env.TRV_MODULE.export(config.module ?? ''),
-        ...config.env
-      }
-    });
-  }
-
   /**
    * Run command synchronously and return output
    */
   static async run(cmd: string, args: string[], config: RunConfig = {}): Promise<string> {
     let final: string;
     try {
-      const subProcess = this.spawn(cmd, args, config);
+      const spawnCmd = config.spawn ?? spawn;
+      const subProcess = spawnCmd(cmd, args, {
+        ...config,
+        cwd: config.workingDirectory ?? this.workingDirectory(config),
+        env: {
+          ...process.env,
+          ...Env.DEBUG.export(false),
+          ...Env.TRV_CLI_IPC.export(undefined),
+          ...Env.TRV_MANIFEST.export(''),
+          ...Env.TRV_BUILD.export('none'),
+          ...Env.TRV_ROLE.export(undefined),
+          ...Env.TRV_MODULE.export(config.module ?? ''),
+          ...config.env
+        }
+      });
+
       const result = await ExecUtil.getResult(subProcess, { catch: true });
       if (!result.valid) {
         throw new Error(result.stderr);

package/src/util/types.ts

@@ -1,9 +1,12 @@
+import type { ChildProcess, SpawnOptions } from 'node:child_process';
+
 export type RunConfig = {
   filter?: (line: string) => boolean;
-  rewrite?: (text: string) => string;
+  rewrite?: (line: string) => string;
   module?: string;
   env?: Record<string, string>;
   workingDirectory?: string;
+  spawn?: (cmd: string, args: string[], options: SpawnOptions) => ChildProcess;
 };
 
 export type CodeProps = { title?: string, src: string | Function, language?: string, outline?: boolean, startRe?: RegExp, endRe?: RegExp };

package/support/cli.doc.ts

@@ -1,6 +1,5 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
-import { spawn } from 'node:child_process';
 
 import { PackageUtil } from '@travetto/manifest';
 import { ExecUtil, Env, Runtime, WatchUtil } from '@travetto/runtime';
@@ -51,7 +50,7 @@ export class DocCommand implements CliCommandShape {
     const [first, ...args] = process.argv.slice(2).filter(arg => !/(-w|--watch)/.test(arg));
     await WatchUtil.watchCompilerEvents('change', async ({ file }) => {
       if (file === this.input) {
-        const subProcess = spawn(process.argv0, [Runtime.trvEntryPoint, first, ...args], {
+        const subProcess = ExecUtil.spawnPackageCommand('trv', [first, ...args], {
           cwd: Runtime.mainSourcePath,
           env: { ...process.env, ...Env.TRV_QUIET.export(true) },
           stdio: 'inherit'