@kitschpatrol/tldraw-cli 3.0.0 → 3.2.0

package/dist/lib/local-tldraw-server.d.ts

@@ -1,8 +1,7 @@
 export default class LocalTldrawServer {
     private readonly tldrData?;
-    verbose: boolean;
     private server?;
-    constructor(tldrData?: string | undefined, verbose?: boolean);
+    constructor(tldrData?: string | undefined);
     close(): void;
     start(): Promise<void>;
     get href(): string;

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

@@ -1,20 +1,19 @@
 import type { TldrawFormat } from './tldraw-to-image';
 export default class TldrawController {
     private readonly href;
-    verbose: boolean;
     private page?;
     private isEmpty?;
     private browser?;
     private client?;
     private originalDarkMode?;
-    constructor(href: string, verbose?: boolean);
+    constructor(href: string);
     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/dist/lib/utilities/logger.d.ts

@@ -0,0 +1,8 @@
+export declare let cli: boolean;
+export declare let verbose: boolean;
+export declare function setCli(value: boolean): void;
+export declare function setVerbose(value: boolean): void;
+export declare function log(...data: unknown[]): void;
+export declare function warn(...data: unknown[]): void;
+export declare function error(...data: unknown[]): void;
+export declare function info(...data: unknown[]): void;

package/dist/tldraw/assets/{index-ehug49np.js → index-l3509weP.js}

@@ -312,4 +312,4 @@ Error generating stack: `+s.message+`
 	font-weight: ${m.weight};
 	font-style: ${m.style};
 	src: url("${o}") format("woff2")
-}`,()=>{document.fonts.delete(m),h=!0}},[e,n]),t};function Eee(e){return{draw:{url:e.fonts.draw},serif:{url:e.fonts.serif},sansSerif:{url:e.fonts.sansSerif},monospace:{url:e.fonts.monospace}}}function _ee(e){const n=x.useMemo(()=>Eee(e),[e]),t=[Fd("tldraw_draw",n.draw),Fd("tldraw_serif",n.serif),Fd("tldraw_sans",n.sansSerif),Fd("tldraw_mono",n.monospace)];return{error:t.some(r=>r===1),done:!t.some(r=>r===2)}}function Iee(e){const{children:n,maxImageDimension:t,maxAssetSize:r,acceptedImageMimeTypes:o,acceptedVideoMimeTypes:s,onMount:i,...a}=e,l=i7(a.components??{}),c=Cx(a.shapeUtils??[]),u=Cx(a.tools??[]),d={initialState:"select",...a,components:x.useMemo(()=>({Scribble:vb,CollaboratorScribble:vb,SelectionForeground:gU,SelectionBackground:pU,Handles:aU,HoveredShapeIndicator:lU,...l}),[l]),shapeUtils:x.useMemo(()=>[..._V,...c],[c]),tools:x.useMemo(()=>[...BV,...iH,...u],[u])},h=DG(a.assetUrls),{done:p,error:m}=_ee(h);return m?g.jsx(n7,{children:"Could not load assets. Please refresh the page."}):p?g.jsx(Qj,{...d,children:g.jsxs(nee,{...d,children:[g.jsx(Pee,{children:g.jsx(Rv,{})}),g.jsx(Tee,{maxImageDimension:t,maxAssetSize:r,acceptedImageMimeTypes:o,acceptedVideoMimeTypes:s,onMount:i}),n]})}):g.jsx(bk,{children:"Loading assets..."})}function Tee({maxImageDimension:e=1e3,maxAssetSize:n=10*1024*1024,acceptedImageMimeTypes:t=["image/jpeg","image/png","image/gif","image/svg+xml"],acceptedVideoMimeTypes:r=["video/mp4","video/quicktime"],onMount:o}){const s=V(),i=$ee(a=>{const l=[];return l.push(...IV(a)),GU(a,{maxImageDimension:e,maxAssetSize:n,acceptedImageMimeTypes:t,acceptedVideoMimeTypes:r}),l.push(o==null?void 0:o(a)),()=>{l.forEach(c=>c==null?void 0:c())}});return x.useLayoutEffect(()=>{if(s)return i==null?void 0:i(s)},[s,i]),null}function $ee(e){const n=x.useRef();return x.useLayoutEffect(()=>{n.current=e}),x.useDebugValue(e),x.useCallback((...t)=>{const r=n.current;return _o(r,"fn does not exist"),r(...t)},[])}const Mee=1,Aee=be({tldrawFileFormatVersion:P5,schema:be({schemaVersion:Uu,storeVersion:Uu,recordVersions:xy(ge,be({version:Uu,subTypeVersions:xy(ge,Uu).optional(),subTypeKey:ge.optional()}))}),records:Xt(be({id:ge,typeName:ge}).allowUnknownProperties())});function Oee(e){var n;try{return!!((n=e.document)!=null&&n.version)}catch{return!1}}function Ree({json:e,schema:n}){let t;try{t=Aee.validate(JSON.parse(e))}catch(o){try{if(t=JSON.parse(e),Oee(t))return Gs.err({type:"v1File",data:t})}catch{}return Gs.err({type:"notATldrawFile",cause:o})}if(t.tldrawFileFormatVersion>Mee)return Gs.err({type:"fileFormatVersionTooNew",version:t.tldrawFileFormatVersion});let r;try{const o=Object.fromEntries(t.records.map(s=>[s.id,s]));r=n.migrateStoreSnapshot({store:o,schema:t.schema})}catch(o){return Gs.err({type:"invalidRecords",cause:o})}if(r.type==="error")return Gs.err({type:"migrationFailed",reason:r.reason});try{return Gs.ok(vk({initialData:r.value,schema:n}))}catch(o){return Gs.err({type:"invalidRecords",cause:o})}}function Dee(){const[e,n]=x.useState();function t(r){e===void 0?fetch("/tldr-data").then(async o=>{if(!o.ok){console.log(`No tldr data to load from local endpoint (${o.status})`);return}return o.text()}).then(o=>{if(o===void 0)return;const s=Ree({json:o,schema:r.store.schema});s.ok?(console.log("Loaded tldr file from local endpoint"),n(s.value)):console.error(`Error parsing tldr file: ${String(s.error.type)}`)}).catch(o=>{console.error("Error fetching data:",o)}):(r.updateViewportScreenBounds(),r.zoomToFit(),window.app.clearOpenMenus())}return g.jsx("div",{style:{inset:0,position:"fixed"},children:g.jsx(Iee,{assetUrls:LA(),onMount:t,store:e})})}var cv={},zC=il;cv.createRoot=zC.createRoot,cv.hydrateRoot=zC.hydrateRoot;cv.createRoot(document.querySelector("#root")).render(g.jsx(ne.StrictMode,{children:g.jsx(Dee,{})}));
+}`,()=>{document.fonts.delete(m),h=!0}},[e,n]),t};function Eee(e){return{draw:{url:e.fonts.draw},serif:{url:e.fonts.serif},sansSerif:{url:e.fonts.sansSerif},monospace:{url:e.fonts.monospace}}}function _ee(e){const n=x.useMemo(()=>Eee(e),[e]),t=[Fd("tldraw_draw",n.draw),Fd("tldraw_serif",n.serif),Fd("tldraw_sans",n.sansSerif),Fd("tldraw_mono",n.monospace)];return{error:t.some(r=>r===1),done:!t.some(r=>r===2)}}function Iee(e){const{children:n,maxImageDimension:t,maxAssetSize:r,acceptedImageMimeTypes:o,acceptedVideoMimeTypes:s,onMount:i,...a}=e,l=i7(a.components??{}),c=Cx(a.shapeUtils??[]),u=Cx(a.tools??[]),d={initialState:"select",...a,components:x.useMemo(()=>({Scribble:vb,CollaboratorScribble:vb,SelectionForeground:gU,SelectionBackground:pU,Handles:aU,HoveredShapeIndicator:lU,...l}),[l]),shapeUtils:x.useMemo(()=>[..._V,...c],[c]),tools:x.useMemo(()=>[...BV,...iH,...u],[u])},h=DG(a.assetUrls),{done:p,error:m}=_ee(h);return m?g.jsx(n7,{children:"Could not load assets. Please refresh the page."}):p?g.jsx(Qj,{...d,children:g.jsxs(nee,{...d,children:[g.jsx(Pee,{children:g.jsx(Rv,{})}),g.jsx(Tee,{maxImageDimension:t,maxAssetSize:r,acceptedImageMimeTypes:o,acceptedVideoMimeTypes:s,onMount:i}),n]})}):g.jsx(bk,{children:"Loading assets..."})}function Tee({maxImageDimension:e=1e3,maxAssetSize:n=10*1024*1024,acceptedImageMimeTypes:t=["image/jpeg","image/png","image/gif","image/svg+xml"],acceptedVideoMimeTypes:r=["video/mp4","video/quicktime"],onMount:o}){const s=V(),i=$ee(a=>{const l=[];return l.push(...IV(a)),GU(a,{maxImageDimension:e,maxAssetSize:n,acceptedImageMimeTypes:t,acceptedVideoMimeTypes:r}),l.push(o==null?void 0:o(a)),()=>{l.forEach(c=>c==null?void 0:c())}});return x.useLayoutEffect(()=>{if(s)return i==null?void 0:i(s)},[s,i]),null}function $ee(e){const n=x.useRef();return x.useLayoutEffect(()=>{n.current=e}),x.useDebugValue(e),x.useCallback((...t)=>{const r=n.current;return _o(r,"fn does not exist"),r(...t)},[])}const Mee=1,Aee=be({tldrawFileFormatVersion:P5,schema:be({schemaVersion:Uu,storeVersion:Uu,recordVersions:xy(ge,be({version:Uu,subTypeVersions:xy(ge,Uu).optional(),subTypeKey:ge.optional()}))}),records:Xt(be({id:ge,typeName:ge}).allowUnknownProperties())});function Oee(e){var n;try{return!!((n=e.document)!=null&&n.version)}catch{return!1}}function Ree({json:e,schema:n}){let t;try{t=Aee.validate(JSON.parse(e))}catch(o){try{if(t=JSON.parse(e),Oee(t))return Gs.err({type:"v1File",data:t})}catch{}return Gs.err({type:"notATldrawFile",cause:o})}if(t.tldrawFileFormatVersion>Mee)return Gs.err({type:"fileFormatVersionTooNew",version:t.tldrawFileFormatVersion});let r;try{const o=Object.fromEntries(t.records.map(s=>[s.id,s]));r=n.migrateStoreSnapshot({store:o,schema:t.schema})}catch(o){return Gs.err({type:"invalidRecords",cause:o})}if(r.type==="error")return Gs.err({type:"migrationFailed",reason:r.reason});try{return Gs.ok(vk({initialData:r.value,schema:n}))}catch(o){return Gs.err({type:"invalidRecords",cause:o})}}function Dee(){const[e,n]=x.useState();function t(r){e===void 0?fetch("/tldr-data").then(async o=>{if(!o.ok){console.log(`No tldr data to load from local endpoint (${o.status})`);return}return o.text()}).then(o=>{if(o===void 0)return;const s=Ree({json:o,schema:r.store.schema});s.ok?(console.log("Loaded tldr file from local endpoint"),n(s.value)):console.error(`Couldn't parse tldr file: ${String(s.error.type)}`)}).catch(o=>{console.error("Couldn't fetch data:",o)}):(r.updateViewportScreenBounds(),r.zoomToFit(),window.app.clearOpenMenus())}return g.jsx("div",{style:{inset:0,position:"fixed"},children:g.jsx(Iee,{assetUrls:LA(),onMount:t,store:e})})}var cv={},zC=il;cv.createRoot=zC.createRoot,cv.hydrateRoot=zC.hydrateRoot;cv.createRoot(document.querySelector("#root")).render(g.jsx(ne.StrictMode,{children:g.jsx(Dee,{})}));

package/dist/tldraw/index.html

@@ -4,7 +4,7 @@
 		<meta charset="UTF-8" />
 		<meta name="viewport" content="width=device-width, initial-scale=1.0" />
 		<title>tldraw via tldraw-cli</title>
-		<script type="module" crossorigin src="/assets/index-ehug49np.js"></script>
+		<script type="module" crossorigin src="/assets/index-l3509weP.js"></script>
 		<link rel="stylesheet" crossorigin href="/assets/index-S3CdIkLU.css">
 	</head>
 	<body>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kitschpatrol/tldraw-cli",
-  "version": "3.0.0",
+  "version": "3.2.0",
   "type": "module",
   "description": "A tiny little CLI tool for exporting tldraw sketches to svg or png images.",
   "repository": {
@@ -56,6 +56,7 @@
     "@types/yargs": "^17.0.32",
     "@vitejs/plugin-react-swc": "^3.5.0",
     "bumpp": "^9.3.0",
+    "chalk": "^5.3.0",
     "cheerio": "1.0.0-rc.12",
     "esbuild": "^0.19.11",
     "eslint-plugin-react-hooks": "^4.6.0",
@@ -64,6 +65,8 @@
     "nanoid": "^5.0.4",
     "open": "^10.0.3",
     "path-type": "^5.0.0",
+    "plur": "^5.1.0",
+    "pretty-ms": "^9.0.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "tsx": "^4.7.0",

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
 
@@ -44,9 +44,9 @@ tldraw-cli <command>
 
 The top-level collection of CLI tools for tldraw.
 
-| Argument  | Description         |
-| --------- | ------------------- |
-| `command` | `export` or `open`. |
+| Argument  | Description                                                       |
+| --------- | ----------------------------------------------------------------- |
+| `command` | CLI tools for tldraw. Available commands are `export` and `open`. |
 
 | Option      | Alias | Description Value    |
 | ----------- | ----- | -------------------- |
@@ -56,52 +56,51 @@ The top-level collection of CLI tools for tldraw.
 #### Command: Export
 
 ```sh
-tldraw-cli export <file-or-url>
+tldraw-cli export <files-or-urls..>
 ```
 
-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                                                                                                                                                                                                                                                      |
+| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `<files-or-urls..>` | The tldraw sketch to export. May be one or more paths to local `.tldr` files, or tldraw.com sketch URLs. Accepts a mix of both file paths and URLs, and supports glob matching via your shell. 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`         |
+| `--output <string>` | `-o`  | Output image directory.                                                                                                                                              | `./`          |
+| `--name <string>`   | `-n`  | Output image 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`       |
+| `--transparent `    | `-t`  | Export an image with a transparent background.                                                                                                                       | `false`       |
+| `--dark-mode `      | `-d`  | Export a dark theme version of the image.                                                                                                                            | `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. Applies to SVG output only.   | `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 logging. All verbose logs and prefixed with their log level and are printed to `stderr` for ease of redirection.                                      | `false`       |
 
 #### Command: Open
 
 ```sh
-tldraw-cli open [file-or-url]
+tldraw-cli open [files-or-urls..]
 ```
 
-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 temporarily copied to the local system, and will not be kept in sync with tldraw.com.
 
-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 the `open` command is only recommended for viewing purposes at the moment._
 
-"Save as" support is not yet implemented in the local tldraw instance, so it's recommended for viewing purposes only 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                                                                                                                                                                                |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `[files-or-urls..]` | The `.tldr` file(s) or tldraw\.com sketch URL(s) to open. Omit the argument to open a blank sketch. Supports glob matching via your shell. 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 +108,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 +136,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 +144,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 +152,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 +173,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
+tldraw-cli export https://www.tldraw.com/s/v2_c_FI5RYWbdpAtjsy4OIKrKw --frames "Frame 3"
+```
+
+### Export multiple frames 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 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 +245,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 +256,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',
@@ -293,10 +304,13 @@ The local instance of tldraw includes its assets dependencies, so the tool shoul
 This is a very minimal implementation. Current plans for future improvements include the following:
 
 - Add save button to local tldraw
+- Accept globs and optimize batch processing with a single puppeteer instance
 - Add CLI tests
 - 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.