@openpresentation/opf 0.17.0 → 0.18.3

package/dist/{conversion-SBpTOwdg.d.ts → conversion-BxZbBd_0.d.ts}

@@ -1,10 +1,10 @@
-import { a as DeckFormat } from './deck-report-Bx3naFlF.js';
-import { F as Finding, f as FindingSeverity } from './finding-CDQ_wH8j.js';
-import { P as Presentation } from './presentation-fb8CZmRq.js';
-import { f as ValidationReport, e as ValidationChecks, c as ValidateOptions } from './validation-types-iZbXfES6.js';
-import { b as Catalog } from './catalog-refs-C4K4y-vh.js';
+import { D as DeckFormat } from './deck-report-DiDf_Vew.js';
+import { a as Finding, c as FindingSeverity } from './finding-CT_f_vbD.js';
+import { P as Presentation } from './presentation-81rNihF0.js';
+import { V as ValidationReport, f as ValidationChecks, a as ValidateOptions } from './validation-types-PbGDrNUr.js';
+import { a as Catalog } from './catalog-refs-BSfGELpt.js';
 
-/** The base class: thrown for the request and the files (`invalid-option`, `input-not-found`, `input-unreadable`, `invalid-presentation`, `output-exists`, `output-not-file`, `output-unwritable`). */
+/** The base class: thrown for the request and the files (`node-only` in the browser build, `invalid-option`, `input-not-found`, `input-unreadable`, `invalid-presentation`, `output-exists`, `output-not-file`, `output-unwritable`). */
 declare class OPFApiError extends Error {
     readonly code: string;
     readonly details: Record<string, unknown>;
@@ -28,12 +28,23 @@ declare function asApiError<T extends OPFApiError>(Class: new (message: string,
     cause?: unknown;
 }) => T, error: unknown, fallbackCode: string): T;
 
+/** A slide selection: one slide number, a list of them, or text such as `"1,3-5"`, `"2-"` (to the end) or `"-3"` (from the start). Slides count from 1. */
+type SlideSelection = number | string | readonly number[];
+/**
+ * The slide numbers a selection names in a presentation of `total` slides: one-based, ascending, without repeats. A number or a
+ * list of numbers names those slides; text names slides and ranges, separated by commas: `"1,3-5"`, `"2-"` (from 2 to the end)
+ * and `"-3"` (from the start to 3). Throws `OPFApiError` `no-slides` when `total` is 0, and `invalid-option` for a malformed
+ * selection, a number that is not a whole number from 1, a reversed range or a slide past the end. `label` names the option in
+ * the message (`"slides"`; the opf CLI passes `"--slides"`).
+ */
+declare function parseSlideSelection(selection: SlideSelection, total: number, label?: string): number[];
+
 declare const RENDER_PACKAGE = "@openpresentation/opf-render";
 declare const PPTX_PACKAGE = "@openpresentation/opf-pptx";
 /** Peer ranges. The CLI checks the features it calls rather than the version, so a newer release in range keeps working. */
 declare const PEER_RANGES: {
-    readonly "@openpresentation/opf-render": "^0.17.0";
-    readonly "@openpresentation/opf-pptx": "^0.17.0";
+    readonly "@openpresentation/opf-render": "^0.18.0";
+    readonly "@openpresentation/opf-pptx": "^0.18.0";
 };
 interface Diagnostic {
     code: string;
@@ -80,10 +91,14 @@ interface FontsHandle extends RenderFonts {
         substitute: boolean;
     }[];
 }
+/** The engines of opf-render 0.18 (RR-73). Slides count from 1; a number gives one SVG, a selection a list. */
 interface RenderModule {
-    renderSlideSvg(presentation: unknown, index: number, options?: Record<string, unknown>): string;
-    svgToPng(svg: string, options?: Record<string, unknown>): Promise<Uint8Array>;
-    svgToPdf(svgs: string | string[], options?: Record<string, unknown>): Promise<Uint8Array>;
+    /** One slide of the deck as SVG; slides count from 1. */
+    toSvg(presentation: unknown, slide: number, options?: Record<string, unknown>): string;
+    /** One SVG slide as PNG. */
+    toPng(svg: string, options?: Record<string, unknown>): Promise<Uint8Array>;
+    /** SVG slides as one PDF, a page each. */
+    toPdf(svgs: string[], options?: Record<string, unknown>): Promise<Uint8Array>;
 }
 interface FontsNodeModule {
     loadFonts(options?: Record<string, unknown>): Promise<FontsHandle>;
@@ -98,6 +113,28 @@ interface Peer<T> {
     version: string;
     name: string;
 }
+/**
+ * What the renderer needs besides itself (RR-63): its converters and every font package are optional peers of opf-render, so a host
+ * installs only the ones its outputs use. The versions are the ones the renderer is tested with (its `peerDependencies`).
+ */
+declare const RENDER_EXTRAS: {
+    /** The faces of the office pack, which the CLI and `convert` always load (every format). */
+    readonly fonts: readonly ["@expo-google-fonts/roboto@0.4.3", "@expo-google-fonts/roboto-mono@0.4.2", "@expo-google-fonts/caladea@0.4.2", "@expo-google-fonts/arimo@0.4.3", "@expo-google-fonts/tinos@0.4.2", "@expo-google-fonts/cousine@0.4.3", "@expo-google-fonts/gelasio@0.4.1", "@expo-google-fonts/noto-sans@0.4.2"];
+    /** PNG output (and raster fallbacks): the SVG rasterizer, and sharp for WebP and rotated JPEG pictures. */
+    readonly png: readonly ["@resvg/resvg-js@^2.6.2", "sharp@^0.35.5"];
+    /** PDF: vector mode (the default) needs nothing for text; raster mode needs pdf-lib; pictures in a vector PDF need sharp. */
+    readonly pdfRaster: readonly ["pdf-lib@^1.17.1"];
+    readonly pdfPictures: readonly ["sharp@^0.35.5"];
+};
+/**
+ * A package as the engine would find it (RR-75, `opf doctor`): its manifest resolved from core's location, then the working
+ * directory, then `from` (a file inside another package, for the optional peers opf-render loads itself). Undefined when it is
+ * not installed. Nothing is loaded.
+ */
+declare function locatePackage(name: string, from?: string): {
+    manifest: string;
+    version: string;
+} | undefined;
 /**
  * The missing-peer error for a renderer failure that says a package it loads lazily is absent (RR-63): `converter-missing` (pdf-lib,
  * @resvg/resvg-js, sharp) or `font-resource-unavailable` naming font packages. The renderer's message, with its install command, is kept;
@@ -150,44 +187,51 @@ declare function finishReport(base: Pick<ValidationReport, "valid" | "schemaVali
 
 type ExportFormat = "svg" | "png" | "pdf" | "pptx";
 declare const EXPORT_FORMATS: readonly ExportFormat[];
+/** How an SVG carries its text (RR-74): the faces the slide uses embedded (`fonts`, the default), none (`system`) or glyph outlines (`paths`). */
+type ExportText = "fonts" | "system" | "paths";
+declare const EXPORT_TEXT: readonly ExportText[];
 interface ExportOptions {
     /** What to write. `svg` and `png` give one file per slide (or one zip), `pdf` and `pptx` one file. */
     format: ExportFormat;
-    /** A prepared fonts handle (`loadFonts()` of `@openpresentation/opf-render/fonts-node`), reused across calls. Omitted: the bundled open font pack plus `fontDirs`. */
-    fonts?: FontsHandle;
-    /** Directories of `.ttf` and `.otf` files to load before the bundled pack (not recursive). Ignored when `fonts` is given. */
-    fontDirs?: readonly string[];
+    /**
+     * The fonts: a prepared handle (`loadFonts()` of `@openpresentation/opf-render/fonts-node`), reused across calls, or a folder or
+     * folders of `.ttf` and `.otf` files to load before the bundled pack (not recursive). Omitted: the bundled open font pack.
+     */
+    fonts?: FontsHandle | string | readonly string[];
     /** The catalogs the presentation's references resolve in. Omitted: core's default catalog. */
     catalogs?: readonly Catalog[];
-    /** The slides to write, one-based: numbers or a selection such as `"1,3-5"`. Omitted: every slide that is not hidden. Not for `pptx`. */
-    slides?: readonly number[] | string;
+    /** The slides to write, one-based: a number, numbers or a selection such as `"1,3-5"` (`parseSlideSelection`). Omitted: every slide that is not hidden. Not for `pptx`. */
+    slides?: SlideSelection;
     /** Write hidden slides too (`svg`, `png`, `pdf`). */
     includeHidden?: boolean;
     /** Split overflowing slides with the same fonts before drawing, as `opf paginate` does. */
     paginate?: boolean;
     /** Pixel scale of `png` and of a raster `pdf` (0.1 to 8; 1 draws the 1280 x 720 reference slide at 1280 x 720 pixels). */
     scale?: number;
-    /** `pdf`: `vector` (selectable text, the default) or `raster`. */
-    pdfMode?: "vector" | "raster";
-    /** `svg`: embed the faces the slide's text uses (`used`, the default) or none (`none`). */
-    svgFonts?: "used" | "none";
-    /** `pptx`: native charts (`native`), picture fallbacks (`fallback`) or opf-pptx's choice (`auto`). */
-    chartex?: "auto" | "native" | "fallback";
+    /** `pdf`: draw each slide as a picture (`true`) instead of selectable vector text (the default). */
+    raster?: boolean;
+    /**
+     * `svg`: how the text is carried. `fonts` (the default) embeds the faces the slide's text uses; `system` embeds none, for a page that
+     * already has the fonts; `paths` draws the text as glyph outlines, so the file needs no font.
+     */
+    text?: ExportText;
+    /** `pptx`: native charts (`native`), pictures (`picture`) or opf-pptx's choice (`auto`, the default). */
+    charts?: "auto" | "native" | "picture";
     /** `pptx`: what the file records about where media came from. */
     provenance?: "full" | "references-only" | "none";
     /** `pptx`: keep images as they are (`preserve`) or convert them for older PowerPoint (`compatible`). */
-    imageFormat?: "compatible" | "preserve";
+    images?: "compatible" | "preserve";
     /** `YYYY-MM-DD`, for date fields that show today's date. Nothing reads a clock: without it such a field reports `date-needs-value`. */
     date?: string;
     /** The directory a presentation's relative image paths resolve against. Omitted: no local file is read (data URIs and remote references work as the engines handle them). */
     assetDir?: string;
     /** `svg` and `png`: one zip of the slides instead of one file per slide. */
     zip?: boolean;
-    /** The source file name, for naming the output when the presentation has no `filename` or `name`. */
-    filename?: string;
+    /** The base name of the files (`name-001.png` for slide 1, `name.pdf`). Omitted: the presentation's `filename`, else its slugified `name`, else `deck`. */
+    name?: string;
 }
 interface ExportFile {
-    /** The file name: the presentation's `filename`, else its slugified `name`, else the source name, then `-001.png` for slide 1 and so on. */
+    /** The file name: `options.name`, else the presentation's `filename`, else its slugified `name`, else `deck`, then `-001.png` for slide 1 and so on. */
     name: string;
     /** The media type. */
     type: string;
@@ -207,7 +251,7 @@ interface ExportFile {
 interface ExportFontSummary {
     pack: "office";
     substitutionPolicy: "visual";
-    /** The `fontDirs` files, in load order. */
+    /** The `fonts` folder files, in load order. */
     userFonts: string[];
     substitutions: {
         requested: string;
@@ -237,24 +281,36 @@ interface ExportContext {
     reporter: Reporter;
     renderer?: Renderer;
     pptx?: Peer<PptxModule>;
-    /** Absolute font file paths already listed from `fontDirs`. */
+    /** Absolute font file paths already listed from the `fonts` folders. */
     userFonts?: string[];
-    /** Name options as the command line does (`--slides`, `--font-dir`, `--asset-dir`) in the messages of errors the engine throws. */
+    /** Name options as the command line does (`--slides`, `--fonts`, `--asset-dir`) in the messages of errors the engine throws. */
     flags?: boolean;
 }
 /** `YYYY-MM-DD` and a real calendar date, or undefined. `label` names the option in the message (`--date` for the command, `date` for the function). */
 declare function checkDate(value: unknown, label?: string): string | undefined;
 /** A scale from 0.1 to 8, 1 when absent. */
 declare function checkScale(value: unknown, label?: string): number;
+/** Throws `invalid-option` when `options` uses a name 0.18 renamed. */
+declare function checkRenamedOptions(options: object): void;
+/** The options of a call as the engine reads them: checked, with defaults, and `fonts` split into the handle or the folders. */
+interface ResolvedExportOptions extends Omit<ExportOptions, "fonts" | "text" | "scale"> {
+    format: ExportFormat;
+    text: ExportText;
+    scale: number;
+    /** `fonts`, when it is a prepared handle. */
+    fonts?: FontsHandle;
+    /** `fonts`, when it names folders. */
+    fontFolders: string[];
+}
 /** The options of a call, checked against each other. Throws `invalid-option` (an OPFApiError) for a value out of range or an option that does not apply to the format. */
-declare function resolveExportOptions(options: ExportOptions): Required<Pick<ExportOptions, "format" | "svgFonts" | "scale">> & ExportOptions;
+declare function resolveExportOptions(options: ExportOptions): ResolvedExportOptions;
 /**
  * Draw a presentation that has already passed the format and references check (`ctx.reporter` holds that check's findings).
  * Diagnostics from fonts, layout, the SVG, PDF and PPTX writers are added to `ctx.reporter`. Throws an `OPFApiError` for an
  * option, a missing or old peer, a font directory or a selection that names no slide; a failure while drawing is returned in
  * `failure` after the reporter has the error finding.
  */
-declare function runExport(presentation: unknown, options: ReturnType<typeof resolveExportOptions>, ctx: ExportContext): Promise<ExportRun>;
+declare function runExport(presentation: unknown, options: ResolvedExportOptions, ctx: ExportContext): Promise<ExportRun>;
 declare const VERSIONS: (renderer: Renderer, pptx?: Peer<PptxModule>) => {
     pptx?: {
         package: string;
@@ -318,11 +374,11 @@ interface ImportResult {
 }
 /** An export whose options are checked and whose engines and font files are loaded, before any document is read. */
 interface PreparedExport {
-    options: ReturnType<typeof resolveExportOptions>;
+    options: ResolvedExportOptions;
     renderer: Renderer;
     pptx?: Peer<PptxModule>;
     userFonts: string[];
-    /** Name options as the command's flags (`--slides`, `--font-dir`, `--asset-dir`) in messages. */
+    /** Name options as the command's flags (`--slides`, `--fonts`, `--asset-dir`) in messages. */
     flags: boolean;
 }
 /** Check the options, then load the engines and list the font directories, so a missing install is reported before the document is looked at. */
@@ -342,15 +398,17 @@ declare function importPresentation(bytes: Uint8Array, options: ImportOptions, l
 type ConvertFormat = ExportFormat | DeckFormat;
 /** What `convert` reads: a file path (`.pptx`, `.opf.md`, `.yaml`/`.yml`, `.json`), a deck, or the bytes of a `.pptx` file. */
 type ConvertInput = string | Presentation | Uint8Array | ArrayBuffer;
-interface ConvertOptions extends Omit<ExportOptions, "format" | "filename"> {
+interface ConvertOptions extends Omit<ExportOptions, "format"> {
     /**
      * What to make. With an output path the path's extension names it, and `format` is needed only for a `.zip` (the slides in
      * it: `png`, the default, or `svg`); a `format` that disagrees with the extension is refused. Without an output path it is
      * required: `pdf`, `pptx`, `png`, `svg`, `json`, `yaml` or `markdown`.
      */
     format?: ConvertFormat;
-    /** One archive of the slides instead of one file per slide (`png`, `svg`). With an output path, the path must end `.zip`, and a `.zip` path implies it. */
+    /** Without an output path: one archive of the slides (`png`, `svg`) instead of one file per slide. With an output path, a `.zip` path makes the archive and this option is refused. */
     zip?: boolean;
+    /** Without an output path: the base name of the returned files (`name-001.png`, `name.pdf`). Omitted: the deck's `filename`, else its `name`, else the input file's stem. With an output path, the path names the file and this option is refused. */
+    name?: string;
     /** A `.pptx` input: also return the raw per-shape layout and style signals of the file (`signals` in the result). */
     signals?: boolean;
     /**
@@ -424,7 +482,7 @@ interface ConversionPlan {
 }
 /** The deck form a file name stands for (core's `deckFormatOf`: `.opf.md`, `.yaml`, `.yml`), or JSON for `.json`; undefined for any other name. A plain `.md` file is not a deck. */
 declare function deckFileFormat(file: string): DeckFormat | undefined;
-/** The export format a file name stands for (`.pdf`, `.pptx`, `.png`, `.svg`, any case), else undefined. `opf render` and `opf export` read `--out` with the same rule. */
+/** The export format a file name stands for (`.pdf`, `.pptx`, `.png`, `.svg`, any case), else undefined. `opf convert` reads its output name with this rule. */
 declare function exportFormatOf(file: string): ExportFormat | undefined;
 /** Read an input file: `input-not-found` when there is none, `input-unreadable` for any other failure. */
 declare function readInput(file: string): Promise<Uint8Array>;
@@ -441,4 +499,4 @@ declare function planConversion(input: ConvertInput, output: string | undefined,
  */
 declare function writePlanned(files: readonly ConvertedFile[], overwrite: boolean, flags?: boolean): Promise<void>;
 
-export { runExport as $, asApiError as A, checkDate as B, type ConvertInput as C, type Diagnostic as D, type ExportFormat as E, type FontsHandle as F, checkOptions as G, checkScale as H, type ImportOptions as I, deckFileFormat as J, exportFormatOf as K, finishReport as L, importPresentation as M, loadPptx as N, type OpenOptions as O, type Peer as P, loadRenderer as Q, type Renderer as R, type SaveOptions as S, missingPeerFrom as T, planConversion as U, VERSIONS as V, prepareExport as W, reaches as X, readInput as Y, reportThrown as Z, resolveExportOptions as _, type ConvertOptions as a, runPreparedExport as a0, writePlanned as a1, type ConvertResult as b, type ConvertFormat as c, type SaveResult as d, type ConvertedFile as e, OPFApiError as f, OPFExportError as g, OPFImportError as h, type EmbeddedFace as i, Reporter as j, type PptxModule as k, type ConversionPlan as l, EXPORT_FORMATS as m, type ExportContext as n, type ExportFile as o, type ExportFontSummary as p, type ExportOptions as q, type ExportResult as r, type ExportRun as s, type ImportResult as t, PEER_RANGES as u, PPTX_PACKAGE as v, type PreparedExport as w, RENDER_PACKAGE as x, type ReportFinding as y, type Source as z };
+export { runExport as $, checkRenamedOptions as A, checkScale as B, type ConversionPlan as C, type Diagnostic as D, type EmbeddedFace as E, type FontsHandle as F, deckFileFormat as G, exportFormatOf as H, type ImportOptions as I, finishReport as J, importPresentation as K, loadPptx as L, loadRenderer as M, locatePackage as N, OPFApiError as O, type Peer as P, missingPeerFrom as Q, type Renderer as R, type SlideSelection as S, parseSlideSelection as T, planConversion as U, VERSIONS as V, prepareExport as W, reaches as X, readInput as Y, reportThrown as Z, resolveExportOptions as _, Reporter as a, runPreparedExport as a0, writePlanned as a1, type ConvertInput as a2, type ConvertOptions as a3, type ConvertResult as a4, type ConvertFormat as a5, type OpenOptions as a6, type SaveOptions as a7, type SaveResult as a8, type ConvertedFile as a9, type PptxModule as b, EXPORT_FORMATS as c, EXPORT_TEXT as d, type ExportContext as e, type ExportFile as f, type ExportFontSummary as g, type ExportFormat as h, type ExportOptions as i, type ExportResult as j, type ExportRun as k, type ExportText as l, type ImportResult as m, OPFExportError as n, OPFImportError as o, PEER_RANGES as p, PPTX_PACKAGE as q, type PreparedExport as r, RENDER_EXTRAS as s, RENDER_PACKAGE as t, type ReportFinding as u, type ResolvedExportOptions as v, type Source as w, asApiError as x, checkDate as y, checkOptions as z };

package/dist/convert.d.ts

@@ -1,7 +1,7 @@
-import { P as PaginatedPage, d as PresentationPaginationOptions } from './pagination-BhX4M48Y.js';
-import './composition-BbZ_9C-c.js';
-import './catalog-refs-C4K4y-vh.js';
-import './chart-data-DTxdRRT1.js';
+import { a as PaginatedPage, b as PresentationPaginationOptions } from './pagination-BaUjDrTz.js';
+import './composition-C-OoqvAr.js';
+import './catalog-refs-BSfGELpt.js';
+import './chart-data-BnNqgnC-.js';
 
 type Json = any;
 type Obj = Record<string, any>;

package/dist/convert.js

@@ -1,12 +1,12 @@
-import { paginate, OPFPaginationError } from './chunk-O2CX5NEH.js';
-import { parseQuoteLines, parseCodeFence, splitWhen, parseListLine, levelsFromIndents, fenceCode } from './chunk-ESRYBYLY.js';
-import { CONTENT_KEYS, isRecord, contentKeysOf, refuse, clone, Loss, isSlideLike, assertValidOwner, report, OPFConversionError, plainOf, assertValidOutput, same, splitRuns, runsOf, lineIsPlain, linePlain, concatText, lineValue, joinLines, hasFormatting } from './chunk-PPROJP2E.js';
-export { OPFConversionError } from './chunk-PPROJP2E.js';
-import './chunk-NLNYNBTS.js';
-import { promotedRegionKeys, isDatasetRef, inlineTableData, visitContentPayloads, chartNumber } from './chunk-CW7GEAV3.js';
+import { paginate, OPFPaginationError } from './chunk-FO3WGS4R.js';
+import { parseQuoteLines, parseCodeFence, splitWhen, parseListLine, levelsFromIndents, fenceCode } from './chunk-PNINP5IF.js';
+import { CONTENT_KEYS, isRecord, contentKeysOf, refuse, clone, Loss, isSlideLike, assertValidOwner, report, OPFConversionError, plainOf, assertValidOutput, same, splitRuns, runsOf, lineIsPlain, linePlain, concatText, lineValue, joinLines, hasFormatting } from './chunk-TRELE6I6.js';
+export { OPFConversionError } from './chunk-TRELE6I6.js';
+import './chunk-KA3ZPFVT.js';
+import { promotedRegionKeys, isDatasetRef, inlineTableData, visitContentPayloads, chartNumber } from './chunk-MBU42S5Y.js';
 import './chunk-TRDXRRQK.js';
 import './chunk-SPFV27O5.js';
-import './chunk-RA64UQKI.js';
+import './chunk-2PEWUUBR.js';
 
 // src/convert/tables.ts
 function cellOf(raw) {

package/dist/data.d.ts

@@ -1,5 +1,5 @@
-import { C as Chart } from './presentation-fb8CZmRq.js';
-export { a as ChartMapping, b as ChartNumberFix, c as ChartNumberFixOperation, d as ChartNumberFixOptions, D as DataCellValue, e as DataColumn, f as DataDiagnostic, g as DataDiagnosticCode, h as DataResolveOptions, i as DataSourceRef, j as DataStyledCell, k as DataTableCell, l as DataTableHeader, m as DataTableValue, n as DataTextRun, o as Dataset, p as DatasetRef, R as ResolvedChartData, q as ResolvedTableData, r as chartNumber, s as datasetDiagnostics, t as formatDataNumber, u as fromExcelNumberFormat, v as inlineChartData, w as inlineDatasets, x as inlineTableData, y as isDatasetRef, z as isXYChartType, A as numberFormatError, B as resolveChartData, E as resolveTableData, F as suggestChartNumberFix, G as tableCellDisplayValue, H as toExcelNumberFormat, I as unusedDatasets } from './chart-data-DTxdRRT1.js';
+import { C as Chart } from './presentation-81rNihF0.js';
+export { C as ChartMapping, a as ChartNumberFix, b as ChartNumberFixOperation, c as ChartNumberFixOptions, D as DataCellValue, d as DataColumn, e as DataDiagnostic, f as DataDiagnosticCode, g as DataResolveOptions, h as DataSourceRef, i as DataStyledCell, j as DataTableCell, k as DataTableHeader, l as DataTableValue, m as DataTextRun, n as Dataset, o as DatasetRef, R as ResolvedChartData, p as ResolvedTableData, q as chartNumber, r as datasetDiagnostics, s as formatDataNumber, t as fromExcelNumberFormat, u as inlineChartData, v as inlineDatasets, w as inlineTableData, x as isDatasetRef, y as isXYChartType, z as numberFormatError, A as resolveChartData, B as resolveTableData, E as suggestChartNumberFix, F as tableCellDisplayValue, G as toExcelNumberFormat, H as unusedDatasets } from './chart-data-BnNqgnC-.js';
 
 type DataCell = string | number | boolean | null;
 interface TabularData {
@@ -28,7 +28,7 @@ interface DataImportOptions {
     header?: boolean;
     columns?: string[];
 }
-interface ImportDataOptions extends DataImportOptions {
+interface IngestOptions extends DataImportOptions {
     as: 'table' | 'chart';
     /** Default `column`. Values outside `CHART_TYPES` make an invalid chart; the CLI checks `--chart-type` first. */
     chartType?: ImportedChartType;
@@ -39,12 +39,12 @@ declare class OPFDataImportError extends Error {
     constructor(message: string);
 }
 declare function parseTabularData(input: unknown, options?: DataImportOptions): TabularData;
-declare function importData(input: unknown, options: ImportDataOptions & {
+declare function ingest(input: unknown, options: IngestOptions & {
     as: 'table';
 }): ImportedTable;
-declare function importData(input: unknown, options: ImportDataOptions & {
+declare function ingest(input: unknown, options: IngestOptions & {
     as: 'chart';
 }): ImportedChart;
-declare function importData(input: unknown, options: ImportDataOptions): ImportedTable | ImportedChart;
+declare function ingest(input: unknown, options: IngestOptions): ImportedTable | ImportedChart;
 
-export { type DataCell, type DataImportOptions, type ImportDataOptions, type ImportedChart, type ImportedChartData, type ImportedChartType, type ImportedTable, OPFDataImportError, type TabularData, importData, parseTabularData };
+export { type DataCell, type DataImportOptions, type ImportedChart, type ImportedChartData, type ImportedChartType, type ImportedTable, type IngestOptions, OPFDataImportError, type TabularData, ingest, parseTabularData };

package/dist/data.js

@@ -1,3 +1,3 @@
-export { OPFDataImportError, importData, parseTabularData } from './chunk-O263APNI.js';
-export { chartNumber, datasetDiagnostics, formatDataNumber, fromExcelNumberFormat, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isXYChartType, numberFormatError, resolveChartData, resolveTableData, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets } from './chunk-CW7GEAV3.js';
+export { OPFDataImportError, ingest, parseTabularData } from './chunk-ZCFSDSUX.js';
+export { chartNumber, datasetDiagnostics, formatDataNumber, fromExcelNumberFormat, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isXYChartType, numberFormatError, resolveChartData, resolveTableData, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unusedDatasets } from './chunk-MBU42S5Y.js';
 import './chunk-SPFV27O5.js';

package/dist/{deck-report-Bx3naFlF.d.ts → deck-report-DiDf_Vew.d.ts}

@@ -1,6 +1,6 @@
-import { b as Catalog } from './catalog-refs-C4K4y-vh.js';
-import { P as Presentation } from './presentation-fb8CZmRq.js';
-import { f as ValidationReport, c as ValidateOptions } from './validation-types-iZbXfES6.js';
+import { a as Catalog } from './catalog-refs-BSfGELpt.js';
+import { P as Presentation } from './presentation-81rNihF0.js';
+import { V as ValidationReport, a as ValidateOptions } from './validation-types-PbGDrNUr.js';
 
 /** The serializations of a deck: `json` (canonical), `yaml` (`.opf.yaml`) and `markdown` (`.opf.md`). */
 type DeckFormat = "json" | "yaml" | "markdown";
@@ -33,8 +33,8 @@ interface DeckReport extends ValidationReport {
 }
 /**
  * The reader behind `parse` that never throws for content: the deck and the `validate` report of it, every finding
- * located in the text. Not exported from the package entries; `@openpresentation/opf/node` and `parse` use it.
+ * located in the text. Not exported from the package root; the Node file API and `parse` use it.
  */
 declare function readDeckReport(text: string, options?: DeckReportOptions, caller?: string): DeckReport;
 
-export { DECK_FORMATS as D, type ParseOptions as P, type DeckFormat as a, type DeckReport as b, type DeckReportOptions as c, deckFormatOf as d, readDeckReport as r };
+export { type DeckFormat as D, type ParseOptions as P, DECK_FORMATS as a, type DeckReport as b, type DeckReportOptions as c, deckFormatOf as d, readDeckReport as r };

package/dist/deck.d.ts

@@ -1,11 +1,11 @@
-import { a as DeckFormat, P as ParseOptions } from './deck-report-Bx3naFlF.js';
-export { D as DECK_FORMATS, d as deckFormatOf } from './deck-report-Bx3naFlF.js';
-import { P as Presentation } from './presentation-fb8CZmRq.js';
-import './catalog-refs-C4K4y-vh.js';
-import './validation-types-iZbXfES6.js';
-import './composition-BbZ_9C-c.js';
-import './chart-data-DTxdRRT1.js';
-import './finding-CDQ_wH8j.js';
+import { D as DeckFormat, P as ParseOptions } from './deck-report-DiDf_Vew.js';
+export { a as DECK_FORMATS, d as deckFormatOf } from './deck-report-DiDf_Vew.js';
+import { P as Presentation } from './presentation-81rNihF0.js';
+import './catalog-refs-BSfGELpt.js';
+import './validation-types-PbGDrNUr.js';
+import './composition-C-OoqvAr.js';
+import './chart-data-BnNqgnC-.js';
+import './finding-CT_f_vbD.js';
 import './json-BFSdESOE.js';
 
 /**

package/dist/deck.js

@@ -1,12 +1,12 @@
-export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-N4EVOFEA.js';
-import './chunk-BIC3SWPK.js';
-import './chunk-TCD2FB2K.js';
-import './chunk-IS5H5JKH.js';
-import './chunk-YT7FMQER.js';
-import './chunk-ESRYBYLY.js';
-import './chunk-PPROJP2E.js';
-import './chunk-NLNYNBTS.js';
-import './chunk-CW7GEAV3.js';
+export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-GVOLSWAJ.js';
+import './chunk-MSFE2HUK.js';
+import './chunk-ECP7QPGK.js';
+import './chunk-R7KIASS4.js';
+import './chunk-JCOSZTOI.js';
+import './chunk-PNINP5IF.js';
+import './chunk-TRELE6I6.js';
+import './chunk-KA3ZPFVT.js';
+import './chunk-MBU42S5Y.js';
 import './chunk-TRDXRRQK.js';
 import './chunk-SPFV27O5.js';
-import './chunk-RA64UQKI.js';
+import './chunk-2PEWUUBR.js';

package/dist/diff.d.ts

@@ -1,4 +1,4 @@
-import { J as JsonPatchOperation } from './finding-CDQ_wH8j.js';
+import { J as JsonPatchOperation } from './finding-CT_f_vbD.js';
 
 type MatchedBy = "id" | "equal" | "similar" | "position";
 interface MatchPair {

package/dist/diff.js

@@ -1,7 +1,7 @@
-export { categoryOf, describeValue, diff, formatDiffReport, matchArrays, merge, similarity } from './chunk-M4UR3NPN.js';
-import './chunk-O3CVNJTL.js';
-import './chunk-NLNYNBTS.js';
-import './chunk-CW7GEAV3.js';
+export { categoryOf, describeValue, diff, formatDiffReport, matchArrays, merge, similarity } from './chunk-L5YACLWK.js';
+import './chunk-WHHLGDCQ.js';
+import './chunk-KA3ZPFVT.js';
+import './chunk-MBU42S5Y.js';
 import './chunk-TRDXRRQK.js';
 import './chunk-SPFV27O5.js';
-import './chunk-RA64UQKI.js';
+import './chunk-2PEWUUBR.js';