@kitschpatrol/tldraw-cli 3.0.0 → 3.1.0

package/bin/cli.js

@@ -610,7 +610,7 @@ var require_boolbase = __commonJS({
 });
 
 // package.json
-var version = "2.2.3";
+var version = "3.0.0";
 
 // src/lib/local-tldraw-server.ts
 import express from "express";
@@ -16482,13 +16482,13 @@ var TldrawController = class {
       console.log("Stopped controller");
   }
   // Public method doesn't expose pageFrame
-  async download(output, filename, format3, stripStyle) {
-    return this._download(output, filename, format3, stripStyle);
+  async download(output, filename, format3, stripStyle, print) {
+    return this._download(output, filename, format3, stripStyle, void 0, print);
   }
-  async downloadFrame(output, filename, format3, stripStyle, frameNameOrId) {
-    return this.downloadFrames(output, filename, format3, stripStyle, [frameNameOrId]);
+  async downloadFrame(output, filename, format3, stripStyle, frameNameOrId, print) {
+    return this.downloadFrames(output, filename, format3, stripStyle, [frameNameOrId], print);
   }
-  async downloadFrames(output, filename, format3, stripStyle, frameNamesOrIds) {
+  async downloadFrames(output, filename, format3, stripStyle, frameNamesOrIds, print) {
     const validPageFrames = [];
     for (const frame of frameNamesOrIds) {
       const pageFrame = await this.getPageFrameWithNameOrId(frame);
@@ -16512,15 +16512,22 @@ var TldrawController = class {
     for (const frame of validPageFrames) {
       const frameSuffix = isFrameNameCollision ? `-${frame.id.replace("shape:", "")}` : "";
       outputAccumulator.push(
-        ...await this._download(output, `${filename}${frameSuffix}`, format3, stripStyle, frame)
+        ...await this._download(
+          output,
+          `${filename}${frameSuffix}`,
+          format3,
+          stripStyle,
+          frame,
+          print
+        )
       );
     }
     return outputAccumulator;
   }
-  async downloadAllFrames(output, filename, format3, stripStyle) {
+  async downloadAllFrames(output, filename, format3, stripStyle, print) {
     const pageFrames = await this.getPageFrames();
     const frameNamesOrIds = pageFrames.map((f) => f.id);
-    return this.downloadFrames(output, filename, format3, stripStyle, frameNamesOrIds);
+    return this.downloadFrames(output, filename, format3, stripStyle, frameNamesOrIds, print);
   }
   // Ephemeral means we don't have to restore the user's value
   async setTransparency(transparent) {
@@ -16545,19 +16552,17 @@ var TldrawController = class {
     await this.page.evaluate(`editor.user.updateUserPreferences({ isDarkMode: ${darkMode}})`);
   }
   // eslint-disable-next-line @typescript-eslint/naming-convention
-  async _download(output, filename, format3, stripStyle, pageFrame) {
+  async _download(output, filename, format3, stripStyle, pageFrame, print) {
     if (!this.page)
       throw new Error("Controller not started");
     if (this.isEmpty) {
       throw new Error("Cannot export an empty document");
     }
     if (stripStyle && format3 !== "svg") {
-      console.warn("Warning: --strip-style is only supported for SVG output");
+      console.warn("--strip-style is only supported for SVG output");
     }
     if (pageFrame !== void 0 && format3 === "tldr") {
-      console.warn(
-        "Warning: --frames is not supported for tldr output, downloading entire document"
-      );
+      console.warn("--frames is not supported for tldr output, downloading entire document");
     }
     const completionPromise = this.waitForDownloadCompletion();
     await this.closeMenus();
@@ -16586,15 +16591,24 @@ var TldrawController = class {
     const downloadGuid = await completionPromise;
     await this.page.waitForNetworkIdle();
     const downloadPath = path2.join(os3.tmpdir(), downloadGuid);
-    const outputPath = path2.resolve(
-      untildify(path2.join(output, `${filename}${frameSuffix}.${format3}`))
-    );
-    await fs.rename(downloadPath, outputPath);
+    const outputPath = print ? downloadPath : path2.resolve(untildify(path2.join(output, `${filename}${frameSuffix}.${format3}`)));
+    if (!print)
+      await fs.rename(downloadPath, outputPath);
     if (stripStyle && format3 === "svg") {
       const svg = await fs.readFile(outputPath, "utf8");
       const strippedSvg = this.stripStyleElement(svg);
       await fs.writeFile(outputPath, strippedSvg);
     }
+    if (print) {
+      if (format3 === "png") {
+        const buffer = await fs.readFile(outputPath);
+        const outputBase64 = buffer.toString("base64");
+        return [outputBase64];
+      }
+      const outputString = await fs.readFile(outputPath, "utf8");
+      const outputStringNoNewlines = outputString.replaceAll("\n", "");
+      return [outputStringNoNewlines];
+    }
     return [outputPath];
   }
   async closeMenus() {
@@ -16738,16 +16752,23 @@ var defaultOptions2 = {
   frames: false,
   name: void 0,
   output: "./",
+  print: false,
   stripStyle: false,
   transparent: false,
   verbose: false
 };
 async function tldrawToImage(tldrPathOrUrl, options) {
+  if (options?.print && options.output !== void 0) {
+    throw new Error("Cannot use --output with --print");
+  }
+  if (options?.print && options.name !== void 0) {
+    console.warn("Ignoring --name when using --print");
+  }
   const resolvedOptions = {
     ...defaultOptions2,
     ...stripUndefined(options ?? {})
   };
-  const { darkMode, format: format3, frames, name, output, stripStyle, transparent, verbose } = resolvedOptions;
+  const { darkMode, format: format3, frames, name, output, print, stripStyle, transparent, verbose } = resolvedOptions;
   if (verbose)
     console.time("Export time");
   const validatedPathOrUrl = validatePathOrUrl(tldrPathOrUrl, {
@@ -16776,7 +16797,8 @@ async function tldrawToImage(tldrPathOrUrl, options) {
       output,
       outputFilename,
       format3,
-      stripStyle
+      stripStyle,
+      print
     );
   } else if (Array.isArray(frames) && frames.length > 0) {
     exportReport = await tldrawController.downloadFrames(
@@ -16784,10 +16806,17 @@ async function tldrawToImage(tldrPathOrUrl, options) {
       outputFilename,
       format3,
       stripStyle,
-      frames
+      frames,
+      print
     );
   } else {
-    exportReport = await tldrawController.download(output, outputFilename, format3, stripStyle);
+    exportReport = await tldrawController.download(
+      output,
+      outputFilename,
+      format3,
+      stripStyle,
+      print
+    );
   }
   await tldrawController.close();
   if (isLocal)
@@ -22191,7 +22220,8 @@ await yargs_default(hideBin(process.argv)).scriptName("tldraw-cli").command("$0
     type: "string"
   }).option("output", {
     alias: "o",
-    default: "./",
+    default: void 0,
+    defaultDescription: '"./"',
     describe: "Output image directory.",
     type: "string"
   }).option("name", {
@@ -22223,10 +22253,20 @@ await yargs_default(hideBin(process.argv)).scriptName("tldraw-cli").command("$0
     default: false,
     describe: "Remove all style tags from the SVG output. Applies to SVG output only.",
     type: "boolean"
+  }).option("print", {
+    alias: "p",
+    default: false,
+    describe: "Print the exported image(s) to stdout instead of saving to a file. Incompatible with --output, and overrides --name. PNGs are printed as base64-encoded strings.",
+    type: "boolean"
   }).option("verbose", {
     default: false,
     describe: "Enable verbose output",
     type: "boolean"
+  }).check((argv) => {
+    if (argv.print && argv.output !== void 0) {
+      throw new Error("Cannot use --output with --print");
+    }
+    return true;
   }),
   async (argv) => {
     const {
@@ -22236,6 +22276,7 @@ await yargs_default(hideBin(process.argv)).scriptName("tldraw-cli").command("$0
       frames,
       name,
       output,
+      print,
       stripStyle,
       transparent,
       verbose
@@ -22248,6 +22289,7 @@ await yargs_default(hideBin(process.argv)).scriptName("tldraw-cli").command("$0
         frames,
         name,
         output,
+        print,
         stripStyle,
         transparent,
         verbose

package/dist/lib/index.js

@@ -16471,13 +16471,13 @@ var TldrawController = class {
       console.log("Stopped controller");
   }
   // Public method doesn't expose pageFrame
-  async download(output, filename, format, stripStyle) {
-    return this._download(output, filename, format, stripStyle);
+  async download(output, filename, format, stripStyle, print) {
+    return this._download(output, filename, format, stripStyle, void 0, print);
   }
-  async downloadFrame(output, filename, format, stripStyle, frameNameOrId) {
-    return this.downloadFrames(output, filename, format, stripStyle, [frameNameOrId]);
+  async downloadFrame(output, filename, format, stripStyle, frameNameOrId, print) {
+    return this.downloadFrames(output, filename, format, stripStyle, [frameNameOrId], print);
   }
-  async downloadFrames(output, filename, format, stripStyle, frameNamesOrIds) {
+  async downloadFrames(output, filename, format, stripStyle, frameNamesOrIds, print) {
     const validPageFrames = [];
     for (const frame of frameNamesOrIds) {
       const pageFrame = await this.getPageFrameWithNameOrId(frame);
@@ -16501,15 +16501,22 @@ var TldrawController = class {
     for (const frame of validPageFrames) {
       const frameSuffix = isFrameNameCollision ? `-${frame.id.replace("shape:", "")}` : "";
       outputAccumulator.push(
-        ...await this._download(output, `${filename}${frameSuffix}`, format, stripStyle, frame)
+        ...await this._download(
+          output,
+          `${filename}${frameSuffix}`,
+          format,
+          stripStyle,
+          frame,
+          print
+        )
       );
     }
     return outputAccumulator;
   }
-  async downloadAllFrames(output, filename, format, stripStyle) {
+  async downloadAllFrames(output, filename, format, stripStyle, print) {
     const pageFrames = await this.getPageFrames();
     const frameNamesOrIds = pageFrames.map((f) => f.id);
-    return this.downloadFrames(output, filename, format, stripStyle, frameNamesOrIds);
+    return this.downloadFrames(output, filename, format, stripStyle, frameNamesOrIds, print);
   }
   // Ephemeral means we don't have to restore the user's value
   async setTransparency(transparent) {
@@ -16534,19 +16541,17 @@ var TldrawController = class {
     await this.page.evaluate(`editor.user.updateUserPreferences({ isDarkMode: ${darkMode}})`);
   }
   // eslint-disable-next-line @typescript-eslint/naming-convention
-  async _download(output, filename, format, stripStyle, pageFrame) {
+  async _download(output, filename, format, stripStyle, pageFrame, print) {
     if (!this.page)
       throw new Error("Controller not started");
     if (this.isEmpty) {
       throw new Error("Cannot export an empty document");
     }
     if (stripStyle && format !== "svg") {
-      console.warn("Warning: --strip-style is only supported for SVG output");
+      console.warn("--strip-style is only supported for SVG output");
     }
     if (pageFrame !== void 0 && format === "tldr") {
-      console.warn(
-        "Warning: --frames is not supported for tldr output, downloading entire document"
-      );
+      console.warn("--frames is not supported for tldr output, downloading entire document");
     }
     const completionPromise = this.waitForDownloadCompletion();
     await this.closeMenus();
@@ -16575,15 +16580,24 @@ var TldrawController = class {
     const downloadGuid = await completionPromise;
     await this.page.waitForNetworkIdle();
     const downloadPath = path2.join(os3.tmpdir(), downloadGuid);
-    const outputPath = path2.resolve(
-      untildify(path2.join(output, `${filename}${frameSuffix}.${format}`))
-    );
-    await fs.rename(downloadPath, outputPath);
+    const outputPath = print ? downloadPath : path2.resolve(untildify(path2.join(output, `${filename}${frameSuffix}.${format}`)));
+    if (!print)
+      await fs.rename(downloadPath, outputPath);
     if (stripStyle && format === "svg") {
       const svg = await fs.readFile(outputPath, "utf8");
       const strippedSvg = this.stripStyleElement(svg);
       await fs.writeFile(outputPath, strippedSvg);
     }
+    if (print) {
+      if (format === "png") {
+        const buffer = await fs.readFile(outputPath);
+        const outputBase64 = buffer.toString("base64");
+        return [outputBase64];
+      }
+      const outputString = await fs.readFile(outputPath, "utf8");
+      const outputStringNoNewlines = outputString.replaceAll("\n", "");
+      return [outputStringNoNewlines];
+    }
     return [outputPath];
   }
   async closeMenus() {
@@ -16727,16 +16741,23 @@ var defaultOptions2 = {
   frames: false,
   name: void 0,
   output: "./",
+  print: false,
   stripStyle: false,
   transparent: false,
   verbose: false
 };
 async function tldrawToImage(tldrPathOrUrl, options) {
+  if (options?.print && options.output !== void 0) {
+    throw new Error("Cannot use --output with --print");
+  }
+  if (options?.print && options.name !== void 0) {
+    console.warn("Ignoring --name when using --print");
+  }
   const resolvedOptions = {
     ...defaultOptions2,
     ...stripUndefined(options ?? {})
   };
-  const { darkMode, format, frames, name, output, stripStyle, transparent, verbose } = resolvedOptions;
+  const { darkMode, format, frames, name, output, print, stripStyle, transparent, verbose } = resolvedOptions;
   if (verbose)
     console.time("Export time");
   const validatedPathOrUrl = validatePathOrUrl(tldrPathOrUrl, {
@@ -16765,7 +16786,8 @@ async function tldrawToImage(tldrPathOrUrl, options) {
       output,
       outputFilename,
       format,
-      stripStyle
+      stripStyle,
+      print
     );
   } else if (Array.isArray(frames) && frames.length > 0) {
     exportReport = await tldrawController.downloadFrames(
@@ -16773,10 +16795,17 @@ async function tldrawToImage(tldrPathOrUrl, options) {
       outputFilename,
       format,
       stripStyle,
-      frames
+      frames,
+      print
     );
   } else {
-    exportReport = await tldrawController.download(output, outputFilename, format, stripStyle);
+    exportReport = await tldrawController.download(
+      output,
+      outputFilename,
+      format,
+      stripStyle,
+      print
+    );
   }
   await tldrawController.close();
   if (isLocal)

package/dist/lib/tldraw-controller.d.ts

@@ -11,10 +11,10 @@ export default class TldrawController {
     private get isLocal();
     start(): Promise<void>;
     close(): Promise<void>;
-    download(output: string, filename: string, format: TldrawFormat, stripStyle: boolean): Promise<string[]>;
-    downloadFrame(output: string, filename: string, format: TldrawFormat, stripStyle: boolean, frameNameOrId: string): Promise<string[]>;
-    downloadFrames(output: string, filename: string, format: TldrawFormat, stripStyle: boolean, frameNamesOrIds: string[]): Promise<string[]>;
-    downloadAllFrames(output: string, filename: string, format: TldrawFormat, stripStyle: boolean): Promise<string[]>;
+    download(output: string, filename: string, format: TldrawFormat, stripStyle: boolean, print: boolean): Promise<string[]>;
+    downloadFrame(output: string, filename: string, format: TldrawFormat, stripStyle: boolean, frameNameOrId: string, print: boolean): Promise<string[]>;
+    downloadFrames(output: string, filename: string, format: TldrawFormat, stripStyle: boolean, frameNamesOrIds: string[], print: boolean): Promise<string[]>;
+    downloadAllFrames(output: string, filename: string, format: TldrawFormat, stripStyle: boolean, print: boolean): Promise<string[]>;
     setTransparency(transparent: boolean): Promise<void>;
     setDarkMode(darkMode: boolean): Promise<void>;
     private _download;

package/dist/lib/tldraw-to-image.d.ts

@@ -5,6 +5,7 @@ export type TldrawToImageOptions = {
     frames?: boolean | string[];
     name?: string;
     output?: string;
+    print?: boolean;
     stripStyle?: boolean;
     transparent?: boolean;
     verbose?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitschpatrol/tldraw-cli",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "type": "module",
   "description": "A tiny little CLI tool for exporting tldraw sketches to svg or png images.",
   "repository": {

package/readme.md

@@ -34,7 +34,7 @@ npm install --global @kitschpatrol/tldraw-cli
 
 ### Invocation
 
-To leave room for future functionality, `tldraw-cli` exposes functionality under several sub-commands.
+`tldraw-cli`'s functionality is organized into several sub-commands.
 
 #### Top-level
 
@@ -59,22 +59,23 @@ The top-level collection of CLI tools for tldraw.
 tldraw-cli export <file-or-url>
 ```
 
-Export a tldraw ".tldr" file or tldraw\.com URL to an svg, png image, and other formats.
+Export a tldraw `.tldr` file or tldraw\.com URL to SVG, PNG, and other formats.
 
-| Argument        | Description                                                                                                                                                                   |
-| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `<file-or-url>` | The sketch to convert export an image — either a path to a local ".tldr" file, or a tldraw\.com sketch URL. Prints the absolute path(s) to the exported image(s) to `stdout`. |
+| Argument        | Description                                                                                                                                                  |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `<file-or-url>` | The sketch to export — either a path to a local `.tldr` file, or a tldraw\.com sketch URL. Prints the absolute path(s) to the exported image(s) to `stdout`. |
 
-| Option              | Alias | Description Value                                                                                                                                                              | Default Value |
-| ------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------- |
-| `--format <string>` | `-f`  | Output image format, one of `svg`, `png`, `json`, or `tldr`.                                                                                                                   | `svg`         |
-| `--dark-mode `      | `-d`  | Output a dark theme version of the image.                                                                                                                                      | `false`       |
-| `--transparent `    | `-t`  | Output an image with a transparent background.                                                                                                                                 | `false`       |
-| `--output <string>` | `-o`  | Output directory.                                                                                                                                                              | `./`          |
-| `--name <string>`   | `-n`  | Output file name without extension; by default the original file name or URL id is used.                                                                                       |               |
-| `--frames <array?>` |       | Export each sketch "frame" as a separate image, use the option flag alone to export all frames, or pass one or more frame names or IDs, slugified frame names will also match. | `false`       |
-| `--strip-style`     |       | Remove `<style>` elements from SVG output, useful to lighten the load of embedded fonts or if you are going to provide your own stylesheet for the SVG.                        | `false`       |
-| `--verbose`         |       | Enable verbose output.                                                                                                                                                         | `false`       |
+| Option              | Alias | Description Value                                                                                                                                                | Default Value |
+| ------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
+| `--format <string>` | `-f`  | Output image format, one of `svg`, `png`, `json`, or `tldr`.                                                                                                     | `svg`         |
+| `--dark-mode `      | `-d`  | Output a dark theme version of the image.                                                                                                                        | `false`       |
+| `--transparent `    | `-t`  | Output an image with a transparent background.                                                                                                                   | `false`       |
+| `--output <string>` | `-o`  | Output directory.                                                                                                                                                | `./`          |
+| `--name <string>`   | `-n`  | Output file name without extension; by default the original file name or URL id is used.                                                                         |               |
+| `--frames <array?>` |       | Export each sketch "frame" as a separate image. Pass one or more frame names or IDs to export specific frames, or skip the arguments to export all frames.       | `false`       |
+| `--strip-style`     |       | Remove `<style>` elements from SVG output, useful to lighten the load of embedded fonts if you intend to provide your own stylesheets.                           | `false`       |
+| `--print`           | `-p`  | Print the exported image(s) to stdout instead of saving to a file. Incompatible with --output, and overrides --name. PNGs are printed as base64-encoded strings. | `false`       |
+| `--verbose`         |       | Enable verbose output.                                                                                                                                           | `false`       |
 
 #### Command: Open
 
@@ -82,26 +83,26 @@ Export a tldraw ".tldr" file or tldraw\.com URL to an svg, png image, and other
 tldraw-cli open [file-or-url]
 ```
 
-Open a tldraw ".tldr" file or tldraw\.com URL your default browser. Uses a locally-hosted instance of tldraw. Call `open` without an argument to open a blank sketch.
+Open a tldraw `.tldr` file or tldraw\.com URL your default browser. Uses a locally-hosted instance of tldraw. Call `open` without an argument to open a blank sketch.
 
 Sketches opened via URL are copied to the local system, and will not be kept in sync with tldraw.com.
 
-"Save as" support is not yet implemented in the local tldraw instance, so it's recommended for viewing purposes only at the moment.
+_"Save as" support is not yet implemented in the local tldraw instance, so the `open` command is only recommended for viewing purposes at the moment._
 
-| Argument        | Description                                                                                                                    |
-| --------------- | ------------------------------------------------------------------------------------------------------------------------------ |
-| `[file-or-url]` | The .tldr file or tldraw\.com sketch url to open. Omit to open a blank sketch. Prints the url of the local server to `stdout`. |
+| Argument        | Description                                                                                                                                   |
+| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `[file-or-url]` | The `.tldr` file or tldraw\.com sketch url to open. Omit the argument to open a blank sketch. Prints the url of the local server to `stdout`. |
 
 No options.
 
 ## Examples
 
-### Basic .tldr file image export
+### Basic `.tldr` file image export
 
-To export the file `your-drawing.tldr` to an svg named `your-drawing.svg` in the current working directory, run the following command. Note that the default output format is SVG, and the default export location is the current working directory.
+To export the file `your-drawing.tldr` to an SVG named `your-drawing.svg` in the current working directory, run the following command. Note that the default output format is SVG, and the default export location is the current working directory.
 
 ```sh
-npx @kitschpatrol/tldraw-cli export your-drawing.tldr
+tldraw-cli export your-drawing.tldr
 ```
 
 The file will retain its original name, e.g. `your-drawing.svg`
@@ -109,27 +110,27 @@ The file will retain its original name, e.g. `your-drawing.svg`
 ### Basic tldraw\.com image download
 
 ```sh
-npx @kitschpatrol/tldraw-cli export https://www.tldraw.com/s/v2_c_JsxJk8dag6QsrqExukis4
+tldraw-cli export https://www.tldraw.com/s/v2_c_JsxJk8dag6QsrqExukis4
 ```
 
-The tldraw URL's id (e.g. `v2_c_JsxJk8dag6QsrqExukis4`) will be used for the file name.
+The tldraw.com URL's id (e.g. `v2_c_JsxJk8dag6QsrqExukis4`) will be used for the file name.
 
 This is approximately equivalent to clicking the tldraw\.com "☰ → Edit → Export As → SVG" menu item.
 
 ### Export a remote tldraw\.com image to a local .tldr file
 
 ```sh
-npx @kitschpatrol/tldraw-cli export https://www.tldraw.com/s/v2_c_JsxJk8dag6QsrqExukis4 --format tldr
+tldraw-cli export https://www.tldraw.com/s/v2_c_JsxJk8dag6QsrqExukis4 --format tldr
 ```
 
 This is approximately equivalent to clicking the tldraw\.com "☰ → File → Save a copy" menu item.
 
 Note that using `--format tldr` with a _file path_ instead of a _URL_ will still send the file through the pipeline, but it's effectively a no-op. (Except perhaps rare edge cases where tldraw performs a file format version migration).
 
-### Export to a specific format
+### Export to a specific image / file format
 
 ```sh
-npx @kitschpatrol/tldraw-cli export your-drawing.tldr --format png
+tldraw-cli export your-drawing.tldr --format png
 ```
 
 This is approximately equivalent to clicking the tldraw\.com "☰ → Edit → Export As → PNG" menu item.
@@ -137,7 +138,7 @@ This is approximately equivalent to clicking the tldraw\.com "☰ → Edit → E
 ### Export with a transparent background
 
 ```sh
-npx @kitschpatrol/tldraw-cli export your-drawing.tldr --transparent --format png
+tldraw-cli export your-drawing.tldr --transparent --format png
 ```
 
 This is approximately equivalent to checking the tldraw\.com "☰ → Edit → Export As → ☐ Transparent" menu item.
@@ -145,7 +146,7 @@ This is approximately equivalent to checking the tldraw\.com "☰ → Edit → E
 ### Export to a specific destination
 
 ```sh
-npx @kitschpatrol/tldraw-cli export your-drawing.tldr --output ~/Desktop
+tldraw-cli export your-drawing.tldr --output ~/Desktop
 ```
 
 Exports to `~/Desktop/your-drawing.svg`
@@ -153,15 +154,15 @@ Exports to `~/Desktop/your-drawing.svg`
 ### Export to a specific destination and filename
 
 ```sh
-npx @kitschpatrol/tldraw-cli export your-drawing.tldr --output ~/Desktop --name not-your-drawing
+tldraw-cli export your-drawing.tldr --output ~/Desktop --name not-your-drawing
 ```
 
 Exports to `~/Desktop/not-your-drawing.svg`
 
-### Export all frames from a tldraw URL
+### Export all frames from a tldraw.com URL
 
 ```sh
-npx @kitschpatrol/tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --frames
+tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --frames
 ```
 
 The exported files will be suffixed with their frame name, e.g.:
@@ -174,33 +175,45 @@ The frame name will be slugified.
 
 It's possible in tldraw to give multiple frames in a single sketch the same name. In these cases, the frame ID is used in addition to the name to ensure unique output file names.
 
-### Export a specific frame from a tldraw URL
+### Export a specific frame from a tldraw.com URL
 
 ```sh
-npx @kitschpatrol/tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --frames "Frame 1" "Frame 3"
+tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --frames "Frame 3"
+```
+
+### Export multiple frames from a tldraw.com URL
+
+```sh
+tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --frames "Frame 1" "Frame 3"
 ```
 
 ### Export to JSON
 
 ```sh
-npx @kitschpatrol/tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --frames "Frame 1" "Frame 3"
+tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --format "json"
 ```
 
-The .tldr file format is also JSON under the covers, but the `--format json` flag will yield a slightly different format than `--format tldr`. `--format json` is equivalent to what's produced via the tldraw\.com "☰ → Edit → Export As → JSON" menu item.
+The `.tldr` file format is also JSON under the covers, but the `--format json` flag will yield a slightly different format than `--format tldr`. `--format json` is equivalent to what's produced via the tldraw\.com "☰ → Edit → Export As → JSON" menu item.
 
 I'm not completely clear on the use-case for this format, but since tldr.com supports it, so too shall `tldraw-cli`.
 
-### Open a tldraw URL
+### Write an SVG to stdout
+
+```sh
+tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --print
+```
+
+### Open a tldraw.com URL
 
 ```sh
-npx @kitschpatrol/tldraw-cli open https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw
+tldraw-cli open https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw
 ```
 
 The remote sketch is copied to a locally-hosted instance of tldraw, which is then opened in your default browser.
 
 ## API usage
 
-The `export` command's functionality is also provided as a module for use in TypeScript or JavaScript Node projects.
+The `export` command's functionality is also provided in module form for use in TypeScript or JavaScript Node projects.
 
 The library exports a single async function, `tldrawToImage`, which takes an options argument mirroring the arguments available via the command line. The same default values apply:
 
@@ -234,10 +247,10 @@ import { tldrawToImage } from '@kitschpatrol/tldraw-cli'
 const [imagePath] = await tldrawToImage('./some-file.tldr', { format: 'png', output: './' })
 console.log(`Wrote image to: "${imagePath}"`)
 
-// Convert a remote tldraw URL to SVG
+// Convert a remote tldraw.com URL to SVG
 await tldrawToImage('https://www.tldraw.com/s/v2_c_JsxJk8dag6QsrqExukis4')
 
-// Convert all frames from a single tldraw URL to separate SVGs
+// Convert all frames from a single tldraw.com URL to separate SVGs
 // When the `frames` option is set, the function returns an array
 // of resulting file paths, instead of a solitary string
 const framePathsArray = await tldrawToImage('https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw', {
@@ -245,7 +258,7 @@ const framePathsArray = await tldrawToImage('https://www.tldraw.com/s/v2_c_FI5RY
 })
 console.log(`Wrote frames to: "${framePathsArray}"`)
 
-// Convert a specific frame from a tldraw URL to a PNG
+// Convert a specific frame from a tldraw.com URL to a PNG
 await tldrawToImage('https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw', {
   frames: ['Frame 3'],
   format: 'png',
@@ -297,6 +310,8 @@ This is a very minimal implementation. Current plans for future improvements inc
 - Implement the ability to export specific pages as separate image files
 - Add an option flag to set dpi when exporting to a bitmap format
 - Additional commands beyond sketch conversion / export?
+- There's room for optimization in how tldraw functions are passed to Puppeteer
+- There's room for optimization in the `--print` option implementation
 
 Any other suggestions are welcome.