@opencraw/cli 0.1.44 → 0.1.47

package/README.md

@@ -41,8 +41,8 @@ input recipes) and reports what happened.
 
 | Flag | Meaning |
 |---|---|
-| `--out <file>` | Write records to this JSON Lines file. Without it, records print to stdout as JSON Lines. |
-| `--append` | Keep what `--out` holds and add to it; each line carries `_key`. |
+| `--out <file>` | Write records to this file; **its extension is the format** (see below). Without it, records print to stdout as JSON Lines. |
+| `--append` | Keep what `--out` holds and add to it; each line carries `_key`. `.jsonl` only. |
 | `--resume` | Skip records `--out` already has (needs `--append`). |
 | `--only <id>` | Run only this input recipe; repeat for more than one. |
 | `--dry-run` | One record per input recipe, printed with the scope it was mapped from — for checking a recipe under construction without a full run. |
@@ -54,6 +54,23 @@ input recipes) and reports what happened.
 | `--host-delay <ms>`, `--host-concurrency <n>` | Per-site politeness across every recipe: at least `ms` between two requests to one site, at most `n` in flight. They override the access config's `throttle` defaults. See [access.md](https://github.com/Open-Craw/OpenCraw/blob/main/docs/recipes/access.md#throttling-per-site). |
 | `--plugins <file>` (or `--hooks`) | A plugins module: named exports `hooks` (the recipes' hook steps and transforms), `accessPlugins` (for `{ kind: "plugin" }` access profiles) and `captchaSolvers`. A module whose default export is `{ name: function }` is read as hooks alone. `OPENCRAW_PLUGINS` / `OPENCRAW_HOOKS` when not given; `probe` reads it too. It runs as your code; load only files you trust. See [§6 of the authoring guide](https://github.com/Open-Craw/OpenCraw/blob/main/docs/recipes/authoring.md#6-hooks). |
 
+### Output formats
+
+The extension of `--out` chooses the format. Any other extension is an error, raised before the crawl starts.
+
+| Extension | What is written |
+|---|---|
+| `.jsonl` | One JSON object per line (the record's fields and a `_source`), written as records arrive. The only format `--append`, `--resume` and `--diff` work with. |
+| `.json` | A JSON array of the same objects. |
+| `.csv` | A header row of the output recipe's fields, then one row per record (RFC 4180, UTF-8). |
+| `.xlsx` | An Excel workbook: one sheet named after the output, a violet header row with the filter on and frozen, numbers and booleans kept as numbers and booleans. |
+| `.yml` / `.yaml` | A YAML list of the same objects. |
+| `.html` | One self-contained page that looks like Studio: the OpenCraw logo, the output's name and description, the record count, and the records in a table. Light or dark by the reader's setting; no script. |
+| `.pdf` | That page, printed (A4, landscape, header repeated on each page). Needs a Chromium, as a `web` recipe does: Playwright's, or `OPENCRAW_CHROMIUM` / `--browser-path`. |
+
+The tabular formats (`.csv`, `.xlsx`, `.html`, `.pdf`) carry the output recipe's fields as columns, in the order the recipe declares them; a list or an
+object becomes its JSON in one cell. Everything but `.jsonl` is written when the run closes.
+
 ```sh
 opencraw run recipes/ --out out/products.jsonl --trace
 opencraw run recipes/movie.output.json recipes/tmdb.input.json --dry-run

package/dist/arguments/command.contract.d.ts

@@ -20,6 +20,15 @@ export type Command = {
 } | {
     name: 'validate';
     paths: string[];
+} | {
+    name: 'export';
+    /** A finished run's JSON Lines file. */
+    records: string;
+    /** The output recipe the records were mapped to: it names the columns. */
+    output: string;
+    /** The file to write; its extension is the format. */
+    out: string;
+    options: CommonOptions;
 } | {
     name: 'diff';
     previous: string;

package/dist/arguments/parse-arguments.algorithm.d.ts

@@ -1,5 +1,5 @@
 import type { Command } from './command.contract';
-export declare const USAGE = "opencraw <command> [options]\n\nCommands\n  validate <recipe files or directories...>   Parse and bind the recipes; list every problem with its path.\n  run <recipe files or directories...>        Crawl. Records go to --out as JSON Lines, or to stdout.\n  probe <url>                                 Fetch a page and report where its data lives.\n  diff <previous.jsonl> <current.jsonl>       Compare two runs' records by key: added, removed, changed.\n  studio [folder] [--open <path>]             Open a recipe folder in the browser: run samples, read\n                                               the trace next to the page (needs @opencraw/studio).\n                                               --open prints a link that opens a folder, recipe or\n                                               document straight away.\n\nOptions for run\n  --out <file>        Write records to this JSON Lines file (default: stdout).\n  --append            Keep what --out holds and add to it (each line carries _key).\n  --resume            Skip records --out already has (needs --append).\n  --only <id>         Run only this input recipe (repeatable).\n  --dry-run           One record per input, printed with the scope it was mapped from.\n  --trace             Print the crawl trace to stderr.\n  --headed            Show the browser.\n  --parallel <n>      Run this many input recipes at once (default 1). Iterations inside a recipe\n                      follow its limits.concurrency.\n  --retries <n>       Tries per request that fails in passing (connection, timeout, 429, 5xx), for\n                      recipes whose limits.retry says nothing. Default 3; 1 turns retrying off.\n  --profiles <dir>    Where recipes' session.browserProfile profiles live (or OPENCRAW_PROFILES;\n                      default .opencraw/profiles).\n  --diff <file>       Compare this run's records with a previous run's JSON Lines file (it may be\n                      --out itself: it is read before the crawl). Keys come from the output recipe.\n  --host-delay <ms>   At least this long between two requests to one site, across every recipe.\n  --host-concurrency <n>\n                      At most this many requests to one site in flight, across every recipe.\n                      Both override the access config's \"throttle\" defaults.\n\nOptions for diff\n  --key <a,b>         The fields that identify a record (default: each line's _key).\n  --ignore <a,b>      Fields left out of the comparison (a date the crawl stamps, say).\n  --changes <file>    Also write every change as a JSON line (run --diff takes it too).\n\nOptions for probe\n  --browser           Also render the page in a browser and list the JSON it fetches.\n\nOptions for both\n  --browser-path <p>  A browser binary other than the one Playwright installed (or OPENCRAW_CHROMIUM).\n  --insecure-tls      Accept an intercepting proxy's certificate (or OPENCRAW_INSECURE_TLS=1).\n  --user-agent <ua>   The user agent to send.\n  --access <file>     An access config: proxy profiles, credentials as {{env.NAME}} (or OPENCRAW_ACCESS).\n  --access-profile <name>\n                      The access profile to use when a recipe names none.\n  --plugins <file>    A JavaScript module exporting hooks (the recipes' hook steps and transforms),\n                      accessPlugins (for { kind: \"plugin\" } access profiles) and captchaSolvers\n                      (for session.captcha and captcha steps); --hooks, or OPENCRAW_PLUGINS /\n                      OPENCRAW_HOOKS. It runs as your code: trust it.\n  --help, --version";
+export declare const USAGE = "opencraw <command> [options]\n\nCommands\n  validate <recipe files or directories...>   Parse and bind the recipes; list every problem with its path.\n  run <recipe files or directories...>        Crawl. Records go to --out (its extension picks the format), or to stdout as JSON Lines.\n  probe <url>                                 Fetch a page and report where its data lives.\n  diff <previous.jsonl> <current.jsonl>       Compare two runs' records by key: added, removed, changed.\n  export <records.jsonl> <output recipe> --out <file>\n                                              Write a finished run's records again in another format (the extension\n                                               of --out chooses it, as for run).\n  studio [folder] [--open <path>]             Open a recipe folder in the browser: run samples, read\n                                               the trace next to the page (needs @opencraw/studio).\n                                               --open prints a link that opens a folder, recipe or\n                                               document straight away.\n\nOptions for run\n  --out <file>        Write records to this file; the extension is the format: .jsonl, .json, .csv, .xlsx, .yml/.yaml,\n                      .html (a page that looks like Studio) or .pdf (that page, printed; needs Chromium). Any other\n                      extension is an error. Default: stdout as JSON Lines.\n  --append            Keep what --out holds and add to it (each line carries _key); .jsonl only.\n  --resume            Skip records --out already has (needs --append).\n  --only <id>         Run only this input recipe (repeatable).\n  --dry-run           One record per input, printed with the scope it was mapped from.\n  --trace             Print the crawl trace to stderr.\n  --headed            Show the browser.\n  --parallel <n>      Run this many input recipes at once (default 1). Iterations inside a recipe\n                      follow its limits.concurrency.\n  --retries <n>       Tries per request that fails in passing (connection, timeout, 429, 5xx), for\n                      recipes whose limits.retry says nothing. Default 3; 1 turns retrying off.\n  --profiles <dir>    Where recipes' session.browserProfile profiles live (or OPENCRAW_PROFILES;\n                      default .opencraw/profiles).\n  --diff <file>       Compare this run's records with a previous run's JSON Lines file (it may be\n                      --out itself: it is read before the crawl). Keys come from the output recipe.\n  --host-delay <ms>   At least this long between two requests to one site, across every recipe.\n  --host-concurrency <n>\n                      At most this many requests to one site in flight, across every recipe.\n                      Both override the access config's \"throttle\" defaults.\n\nOptions for diff\n  --key <a,b>         The fields that identify a record (default: each line's _key).\n  --ignore <a,b>      Fields left out of the comparison (a date the crawl stamps, say).\n  --changes <file>    Also write every change as a JSON line (run --diff takes it too).\n\nOptions for probe\n  --browser           Also render the page in a browser and list the JSON it fetches.\n\nOptions for both\n  --browser-path <p>  A browser binary other than the one Playwright installed (or OPENCRAW_CHROMIUM).\n  --insecure-tls      Accept an intercepting proxy's certificate (or OPENCRAW_INSECURE_TLS=1).\n  --user-agent <ua>   The user agent to send.\n  --access <file>     An access config: proxy profiles, credentials as {{env.NAME}} (or OPENCRAW_ACCESS).\n  --access-profile <name>\n                      The access profile to use when a recipe names none.\n  --plugins <file>    A JavaScript module exporting hooks (the recipes' hook steps and transforms),\n                      accessPlugins (for { kind: \"plugin\" } access profiles) and captchaSolvers\n                      (for session.captcha and captcha steps); --hooks, or OPENCRAW_PLUGINS /\n                      OPENCRAW_HOOKS. It runs as your code: trust it.\n  --help, --version";
 /**
  * Turns argv into a command.
  *

package/dist/export/export-records.use-case.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from '../arguments';
+import type { Terminal } from '../terminal';
+/**
+ * Writes a finished run's JSON Lines file again in another format: the extension of `--out` chooses it, as it does for `run`. The output recipe
+ * supplies the columns (its fields, in order, with their types and descriptions).
+ *
+ * @param command - The parsed `export` command.
+ * @param terminal - Where the result and errors go.
+ * @returns The exit code: 0, or 1 when a file cannot be read, the recipe is not an output recipe, or the extension names no format.
+ */
+export declare function exportRecords(command: Extract<Command, {
+    name: 'export';
+}>, terminal: Terminal): Promise<number>;
+//# sourceMappingURL=export-records.use-case.d.ts.map

package/dist/export/index.d.ts

@@ -0,0 +1,2 @@
+export { exportRecords } from './export-records.use-case';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.esm.js

@@ -1,6 +1,6 @@
 import { parseArgs } from 'node:util';
-import { writeFile } from 'node:fs/promises';
-import { readableKey, readRecordsFile, diffRecords, loadAccessConfig, HostAllowlist, AccessBroker, HttpClient, parseXml, BrowserClient, readRecipeSource, parseOutputRecipe, parseInputRecipe, bindRecipeSet, memorySink, jsonLinesSink, createCrawler, RecipeSet, variantLabel, diffOptionsFor, RecipeValidationError, RecipeBindingError, traceLine } from '@opencraw/core';
+import { writeFile, readFile } from 'node:fs/promises';
+import { readableKey, readRecordsFile, diffRecords, fileSink, parseOutputRecipe, outputRecordOf, RecipeValidationError, loadAccessConfig, HostAllowlist, AccessBroker, HttpClient, parseXml, BrowserClient, readRecipeSource, parseInputRecipe, bindRecipeSet, memorySink, createCrawler, RecipeSet, variantLabel, diffOptionsFor, RecipeBindingError, traceLine } from '@opencraw/core';
 import { resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { describePdf, findData, describeWorkbook, describeDeck, describeJson, describeXml, describeHtml } from '@opencraw/probe';
@@ -11,17 +11,22 @@ const USAGE = `opencraw <command> [options]
 
 Commands
   validate <recipe files or directories...>   Parse and bind the recipes; list every problem with its path.
-  run <recipe files or directories...>        Crawl. Records go to --out as JSON Lines, or to stdout.
+  run <recipe files or directories...>        Crawl. Records go to --out (its extension picks the format), or to stdout as JSON Lines.
   probe <url>                                 Fetch a page and report where its data lives.
   diff <previous.jsonl> <current.jsonl>       Compare two runs' records by key: added, removed, changed.
+  export <records.jsonl> <output recipe> --out <file>
+                                              Write a finished run's records again in another format (the extension
+                                               of --out chooses it, as for run).
   studio [folder] [--open <path>]             Open a recipe folder in the browser: run samples, read
                                                the trace next to the page (needs @opencraw/studio).
                                                --open prints a link that opens a folder, recipe or
                                                document straight away.
 
 Options for run
-  --out <file>        Write records to this JSON Lines file (default: stdout).
-  --append            Keep what --out holds and add to it (each line carries _key).
+  --out <file>        Write records to this file; the extension is the format: .jsonl, .json, .csv, .xlsx, .yml/.yaml,
+                      .html (a page that looks like Studio) or .pdf (that page, printed; needs Chromium). Any other
+                      extension is an error. Default: stdout as JSON Lines.
+  --append            Keep what --out holds and add to it (each line carries _key); .jsonl only.
   --resume            Skip records --out already has (needs --append).
   --only <id>         Run only this input recipe (repeatable).
   --dry-run           One record per input, printed with the scope it was mapped from.
@@ -194,6 +199,18 @@ function parseArguments(argv, env = {}) {
           paths: rest
         };
       }
+    case 'export':
+      {
+        if (rest.length !== 2) throw new Error('export needs the records file (JSON Lines) and the output recipe');
+        if (values.out === undefined) throw new Error('export needs --out <file>: its extension is the format');
+        return {
+          name: 'export',
+          records: rest[0],
+          output: rest[1],
+          out: values.out,
+          options
+        };
+      }
     case 'diff':
       {
         if (rest.length !== 2) throw new Error('diff needs two JSON Lines files: the previous run, then the current one');
@@ -339,6 +356,34 @@ async function writeChanges(path, diff) {
   await writeFile(path, diff.changes.map(change => `${JSON.stringify(change)}\n`).join(''));
 }
 
+/**
+ * Writes a finished run's JSON Lines file again in another format: the extension of `--out` chooses it, as it does for `run`. The output recipe
+ * supplies the columns (its fields, in order, with their types and descriptions).
+ *
+ * @param command - The parsed `export` command.
+ * @param terminal - Where the result and errors go.
+ * @returns The exit code: 0, or 1 when a file cannot be read, the recipe is not an output recipe, or the extension names no format.
+ */
+async function exportRecords(command, terminal) {
+  try {
+    const sink = fileSink(command.out, {
+      browser: {
+        executablePath: command.options.browserPath
+      }
+    });
+    const output = parseOutputRecipe(JSON.parse(await readFile(command.output, 'utf8')), command.output);
+    const stored = await readRecordsFile(command.records);
+    await sink.open(output);
+    for (const line of stored) await sink.write(outputRecordOf(line));
+    const summary = await sink.close();
+    terminal.err(`${String(summary.written)} records written to ${summary.location ?? command.out}`);
+    return 0;
+  } catch (error) {
+    if (error instanceof RecipeValidationError) for (const issue of error.issues) terminal.err(`${error.source}: ${issue.path === '' ? '(root)' : issue.path}: ${issue.message}`);else terminal.err(error instanceof Error ? error.message : String(error));
+    return 1;
+  }
+}
+
 /**
  * The access config a command runs with: the file `--access` (or
  * `OPENCRAW_ACCESS`) names, with `--access-profile` as its default.
@@ -793,6 +838,19 @@ async function runRecipes(command, terminal) {
     terminal.err(command.only.length > 0 ? `no input recipe matches --only ${command.only.join(', ')}` : 'no input recipes found');
     return 1;
   }
+  // The extension of --out names the format: one that names none is refused here, before the crawl, not after it.
+  let sink;
+  try {
+    sink = command.dryRun || command.out === undefined ? memorySink() : fileSink(command.out, {
+      append: command.append,
+      browser: {
+        executablePath: command.options.browserPath
+      }
+    });
+  } catch (error) {
+    terminal.err(error instanceof Error ? error.message : String(error));
+    return 1;
+  }
   let access;
   let plugins;
   let previous;
@@ -806,9 +864,6 @@ async function runRecipes(command, terminal) {
     terminal.err(error instanceof Error ? error.message : String(error));
     return 1;
   }
-  const sink = command.dryRun || command.out === undefined ? memorySink() : jsonLinesSink(command.out, {
-    append: command.append
-  });
   const crawler = createCrawler({
     sink,
     access,
@@ -1027,6 +1082,10 @@ async function main(argv, terminal) {
       {
         return diffFiles(command, terminal);
       }
+    case 'export':
+      {
+        return exportRecords(command, terminal);
+      }
     case 'studio':
       {
         return runStudio(command.folder, terminal, undefined, command.plugins, undefined, command.open);

package/dist/src/arguments/command.contract.d.ts

@@ -20,6 +20,15 @@ export type Command = {
 } | {
     name: 'validate';
     paths: string[];
+} | {
+    name: 'export';
+    /** A finished run's JSON Lines file. */
+    records: string;
+    /** The output recipe the records were mapped to: it names the columns. */
+    output: string;
+    /** The file to write; its extension is the format. */
+    out: string;
+    options: CommonOptions;
 } | {
     name: 'diff';
     previous: string;

package/dist/src/arguments/parse-arguments.algorithm.d.ts

@@ -1,5 +1,5 @@
 import type { Command } from './command.contract.js';
-export declare const USAGE = "opencraw <command> [options]\n\nCommands\n  validate <recipe files or directories...>   Parse and bind the recipes; list every problem with its path.\n  run <recipe files or directories...>        Crawl. Records go to --out as JSON Lines, or to stdout.\n  probe <url>                                 Fetch a page and report where its data lives.\n  diff <previous.jsonl> <current.jsonl>       Compare two runs' records by key: added, removed, changed.\n  studio [folder] [--open <path>]             Open a recipe folder in the browser: run samples, read\n                                               the trace next to the page (needs @opencraw/studio).\n                                               --open prints a link that opens a folder, recipe or\n                                               document straight away.\n\nOptions for run\n  --out <file>        Write records to this JSON Lines file (default: stdout).\n  --append            Keep what --out holds and add to it (each line carries _key).\n  --resume            Skip records --out already has (needs --append).\n  --only <id>         Run only this input recipe (repeatable).\n  --dry-run           One record per input, printed with the scope it was mapped from.\n  --trace             Print the crawl trace to stderr.\n  --headed            Show the browser.\n  --parallel <n>      Run this many input recipes at once (default 1). Iterations inside a recipe\n                      follow its limits.concurrency.\n  --retries <n>       Tries per request that fails in passing (connection, timeout, 429, 5xx), for\n                      recipes whose limits.retry says nothing. Default 3; 1 turns retrying off.\n  --profiles <dir>    Where recipes' session.browserProfile profiles live (or OPENCRAW_PROFILES;\n                      default .opencraw/profiles).\n  --diff <file>       Compare this run's records with a previous run's JSON Lines file (it may be\n                      --out itself: it is read before the crawl). Keys come from the output recipe.\n  --host-delay <ms>   At least this long between two requests to one site, across every recipe.\n  --host-concurrency <n>\n                      At most this many requests to one site in flight, across every recipe.\n                      Both override the access config's \"throttle\" defaults.\n\nOptions for diff\n  --key <a,b>         The fields that identify a record (default: each line's _key).\n  --ignore <a,b>      Fields left out of the comparison (a date the crawl stamps, say).\n  --changes <file>    Also write every change as a JSON line (run --diff takes it too).\n\nOptions for probe\n  --browser           Also render the page in a browser and list the JSON it fetches.\n\nOptions for both\n  --browser-path <p>  A browser binary other than the one Playwright installed (or OPENCRAW_CHROMIUM).\n  --insecure-tls      Accept an intercepting proxy's certificate (or OPENCRAW_INSECURE_TLS=1).\n  --user-agent <ua>   The user agent to send.\n  --access <file>     An access config: proxy profiles, credentials as {{env.NAME}} (or OPENCRAW_ACCESS).\n  --access-profile <name>\n                      The access profile to use when a recipe names none.\n  --plugins <file>    A JavaScript module exporting hooks (the recipes' hook steps and transforms),\n                      accessPlugins (for { kind: \"plugin\" } access profiles) and captchaSolvers\n                      (for session.captcha and captcha steps); --hooks, or OPENCRAW_PLUGINS /\n                      OPENCRAW_HOOKS. It runs as your code: trust it.\n  --help, --version";
+export declare const USAGE = "opencraw <command> [options]\n\nCommands\n  validate <recipe files or directories...>   Parse and bind the recipes; list every problem with its path.\n  run <recipe files or directories...>        Crawl. Records go to --out (its extension picks the format), or to stdout as JSON Lines.\n  probe <url>                                 Fetch a page and report where its data lives.\n  diff <previous.jsonl> <current.jsonl>       Compare two runs' records by key: added, removed, changed.\n  export <records.jsonl> <output recipe> --out <file>\n                                              Write a finished run's records again in another format (the extension\n                                               of --out chooses it, as for run).\n  studio [folder] [--open <path>]             Open a recipe folder in the browser: run samples, read\n                                               the trace next to the page (needs @opencraw/studio).\n                                               --open prints a link that opens a folder, recipe or\n                                               document straight away.\n\nOptions for run\n  --out <file>        Write records to this file; the extension is the format: .jsonl, .json, .csv, .xlsx, .yml/.yaml,\n                      .html (a page that looks like Studio) or .pdf (that page, printed; needs Chromium). Any other\n                      extension is an error. Default: stdout as JSON Lines.\n  --append            Keep what --out holds and add to it (each line carries _key); .jsonl only.\n  --resume            Skip records --out already has (needs --append).\n  --only <id>         Run only this input recipe (repeatable).\n  --dry-run           One record per input, printed with the scope it was mapped from.\n  --trace             Print the crawl trace to stderr.\n  --headed            Show the browser.\n  --parallel <n>      Run this many input recipes at once (default 1). Iterations inside a recipe\n                      follow its limits.concurrency.\n  --retries <n>       Tries per request that fails in passing (connection, timeout, 429, 5xx), for\n                      recipes whose limits.retry says nothing. Default 3; 1 turns retrying off.\n  --profiles <dir>    Where recipes' session.browserProfile profiles live (or OPENCRAW_PROFILES;\n                      default .opencraw/profiles).\n  --diff <file>       Compare this run's records with a previous run's JSON Lines file (it may be\n                      --out itself: it is read before the crawl). Keys come from the output recipe.\n  --host-delay <ms>   At least this long between two requests to one site, across every recipe.\n  --host-concurrency <n>\n                      At most this many requests to one site in flight, across every recipe.\n                      Both override the access config's \"throttle\" defaults.\n\nOptions for diff\n  --key <a,b>         The fields that identify a record (default: each line's _key).\n  --ignore <a,b>      Fields left out of the comparison (a date the crawl stamps, say).\n  --changes <file>    Also write every change as a JSON line (run --diff takes it too).\n\nOptions for probe\n  --browser           Also render the page in a browser and list the JSON it fetches.\n\nOptions for both\n  --browser-path <p>  A browser binary other than the one Playwright installed (or OPENCRAW_CHROMIUM).\n  --insecure-tls      Accept an intercepting proxy's certificate (or OPENCRAW_INSECURE_TLS=1).\n  --user-agent <ua>   The user agent to send.\n  --access <file>     An access config: proxy profiles, credentials as {{env.NAME}} (or OPENCRAW_ACCESS).\n  --access-profile <name>\n                      The access profile to use when a recipe names none.\n  --plugins <file>    A JavaScript module exporting hooks (the recipes' hook steps and transforms),\n                      accessPlugins (for { kind: \"plugin\" } access profiles) and captchaSolvers\n                      (for session.captcha and captcha steps); --hooks, or OPENCRAW_PLUGINS /\n                      OPENCRAW_HOOKS. It runs as your code: trust it.\n  --help, --version";
 /**
  * Turns argv into a command.
  *

package/dist/src/export/export-records.use-case.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from '../arguments/index.js';
+import type { Terminal } from '../terminal/index.js';
+/**
+ * Writes a finished run's JSON Lines file again in another format: the extension of `--out` chooses it, as it does for `run`. The output recipe
+ * supplies the columns (its fields, in order, with their types and descriptions).
+ *
+ * @param command - The parsed `export` command.
+ * @param terminal - Where the result and errors go.
+ * @returns The exit code: 0, or 1 when a file cannot be read, the recipe is not an output recipe, or the extension names no format.
+ */
+export declare function exportRecords(command: Extract<Command, {
+    name: 'export';
+}>, terminal: Terminal): Promise<number>;
+//# sourceMappingURL=export-records.use-case.d.ts.map

package/dist/src/export/index.d.ts

@@ -0,0 +1,2 @@
+export { exportRecords } from './export-records.use-case.js';
+//# sourceMappingURL=index.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencraw/cli",
-  "version": "0.1.44",
+  "version": "0.1.47",
   "type": "module",
   "main": "./dist/index.esm.js",
   "module": "./dist/index.esm.js",
@@ -24,12 +24,12 @@
     "!**/*.js.map"
   ],
   "dependencies": {
-    "@opencraw/core": "^0.1.40",
-    "@opencraw/probe": "^0.0.23",
+    "@opencraw/core": "^0.1.42",
+    "@opencraw/probe": "^0.0.25",
     "playwright": "^1.63.0"
   },
   "peerDependencies": {
-    "@opencraw/studio": "^0.0.33"
+    "@opencraw/studio": "^0.0.36"
   },
   "peerDependenciesMeta": {
     "@opencraw/studio": {