@openpresentation/opf 0.18.3 → 0.19.0

package/dist/{chunk-L5YACLWK.js → chunk-SEUJIS55.js}

@@ -1,5 +1,5 @@
-import { jsonEqual, formatPointer } from './chunk-WHHLGDCQ.js';
-import { annotationText } from './chunk-MBU42S5Y.js';
+import { jsonEqual, formatPointer } from './chunk-WHKFIFN7.js';
+import { annotationText } from './chunk-ZPCKGGI6.js';
 
 // src/diff-match.ts
 var DEFAULT_MATCH_THRESHOLD = 0.5;

package/dist/{chunk-ECP7QPGK.js → chunk-SIQWYDFF.js}

@@ -1,9 +1,9 @@
-import { NOT_CHECKED, Ctx } from './chunk-R7KIASS4.js';
-import { sortPresentationKeys } from './chunk-JCOSZTOI.js';
-import { same } from './chunk-TRELE6I6.js';
-import { validate } from './chunk-KA3ZPFVT.js';
-import { checkCatalogsOption } from './chunk-SPFV27O5.js';
-import { presentation } from './chunk-2PEWUUBR.js';
+import { NOT_CHECKED, Ctx } from './chunk-LRPSMQ62.js';
+import { sortPresentationKeys } from './chunk-A6COIVTD.js';
+import { same } from './chunk-HBFRNOP4.js';
+import { validate } from './chunk-65GDO6TJ.js';
+import { checkCatalogsOption } from './chunk-ZPCKGGI6.js';
+import { presentation } from './chunk-R5T4H4ZV.js';
 import { Parser, parseDocument, isMap, Document, visit, isScalar, isAlias, isSeq } from 'yaml';
 
 var MAX_ALIAS_COUNT = 100;

package/dist/chunk-UJSAR6GF.js

@@ -0,0 +1,181 @@
+// src/generated/spec-files.ts
+var specFileEntries = [
+  {
+    "path": "README.md",
+    "packagePath": "@openpresentation/opf/spec/README.md",
+    "kind": "spec",
+    "mediaType": "text/markdown"
+  },
+  {
+    "path": "openapi.yaml",
+    "packagePath": "@openpresentation/opf/spec/openapi.yaml",
+    "kind": "openapi",
+    "mediaType": "application/yaml"
+  },
+  {
+    "path": "reference/engine-defaults.json",
+    "packagePath": "@openpresentation/opf/spec/reference/engine-defaults.json",
+    "kind": "reference",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "reference/engine-vocabularies.json",
+    "packagePath": "@openpresentation/opf/spec/reference/engine-vocabularies.json",
+    "kind": "reference",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "reference/font-policy.json",
+    "packagePath": "@openpresentation/opf/spec/reference/font-policy.json",
+    "kind": "reference",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "reference/font-policy.schema.json",
+    "packagePath": "@openpresentation/opf/spec/reference/font-policy.schema.json",
+    "kind": "reference",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "reference/symbol-font-encodings.json",
+    "packagePath": "@openpresentation/opf/spec/reference/symbol-font-encodings.json",
+    "kind": "reference",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "reference/symbol-font-encodings.schema.json",
+    "packagePath": "@openpresentation/opf/spec/reference/symbol-font-encodings.schema.json",
+    "kind": "reference",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/audience.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/audience.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/catalog-index.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/catalog-index.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/catalog-manifest.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/catalog-manifest.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/chart-type.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/chart-type.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/color-scheme.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/color-scheme.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/finding.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/finding.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/font-scheme.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/font-scheme.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/language.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/language.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/layout-preview-index.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/layout-preview-index.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/layout.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/layout.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/narrative.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/narrative.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/opf.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/opf.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/purpose.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/purpose.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/social-platform.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/social-platform.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/theme.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/theme.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  },
+  {
+    "path": "schemas/tone.schema.json",
+    "packagePath": "@openpresentation/opf/spec/schemas/tone.schema.json",
+    "kind": "schema",
+    "mediaType": "application/json"
+  }
+];
+var specFilePaths = [
+  "README.md",
+  "openapi.yaml",
+  "reference/engine-defaults.json",
+  "reference/engine-vocabularies.json",
+  "reference/font-policy.json",
+  "reference/font-policy.schema.json",
+  "reference/symbol-font-encodings.json",
+  "reference/symbol-font-encodings.schema.json",
+  "schemas/audience.schema.json",
+  "schemas/catalog-index.schema.json",
+  "schemas/catalog-manifest.schema.json",
+  "schemas/chart-type.schema.json",
+  "schemas/color-scheme.schema.json",
+  "schemas/finding.schema.json",
+  "schemas/font-scheme.schema.json",
+  "schemas/language.schema.json",
+  "schemas/layout-preview-index.schema.json",
+  "schemas/layout.schema.json",
+  "schemas/narrative.schema.json",
+  "schemas/opf.schema.json",
+  "schemas/purpose.schema.json",
+  "schemas/social-platform.schema.json",
+  "schemas/theme.schema.json",
+  "schemas/tone.schema.json"
+];
+var specFileKinds = [
+  "spec",
+  "openapi",
+  "reference",
+  "schema"
+];
+
+export { specFileEntries, specFileKinds, specFilePaths };

package/dist/{chunk-IM337HP5.js → chunk-V3RGXJJS.js}

@@ -1,8 +1,7 @@
-import { OPFDataImportError, parseTabularData } from './chunk-ZCFSDSUX.js';
-import { applyPatchWithInverse } from './chunk-WHHLGDCQ.js';
-import { validate, OPFValidationError } from './chunk-KA3ZPFVT.js';
-import { isRecord, visitContentPayloads, listVariables, resolveVariables, LOGO_SHAPES, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-MBU42S5Y.js';
-import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN } from './chunk-SPFV27O5.js';
+import { OPFDataImportError, parseTabularData } from './chunk-AK4UXIRP.js';
+import { applyPatchWithInverse } from './chunk-WHKFIFN7.js';
+import { validate, OPFValidationError } from './chunk-65GDO6TJ.js';
+import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN, isRecord, visitContentPayloads, listVariables, resolveVariables, LOGO_SHAPES, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-ZPCKGGI6.js';
 
 // src/api-errors.ts
 var OPFApiError = class extends Error {

package/dist/{chunk-WHHLGDCQ.js → chunk-WHKFIFN7.js}

@@ -1,4 +1,4 @@
-import { validate } from './chunk-KA3ZPFVT.js';
+import { validate } from './chunk-65GDO6TJ.js';
 
 // src/patch.ts
 var OPFPatchError = class extends Error {

package/dist/{chunk-K5EG3UMS.js → chunk-XWMKAJSS.js}

@@ -1,8 +1,8 @@
-import { OPFApiError, parseSlideSelection, OPFExportError, asApiError, OPFImportError } from './chunk-IM337HP5.js';
-import { defaultCatalog } from './chunk-WCG3THTD.js';
-import { deckFormatOf, readDeckReport, stringify } from './chunk-GVOLSWAJ.js';
-import { paginate } from './chunk-FO3WGS4R.js';
-import { validate, OPFValidationError } from './chunk-KA3ZPFVT.js';
+import { defaultCatalogs } from './chunk-OOT5AY4V.js';
+import { OPFApiError, parseSlideSelection, OPFExportError, asApiError, OPFImportError } from './chunk-V3RGXJJS.js';
+import { deckFormatOf, readDeckReport, stringify } from './chunk-GRN3U5JT.js';
+import { paginate } from './chunk-OVBGGGKO.js';
+import { validate, OPFValidationError } from './chunk-65GDO6TJ.js';
 import { stat, readdir, lstat, mkdir, writeFile, rename, unlink, readFile } from 'fs/promises';
 import path6 from 'path';
 import { readFileSync, realpathSync, statSync } from 'fs';
@@ -11,8 +11,6 @@ import { createRequire } from 'module';
 import { randomUUID } from 'crypto';
 import { crc32 } from 'zlib';
 
-// src/node/catalogs.ts
-var DEFAULT_CATALOGS = [defaultCatalog];
 var MEDIA = { ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".gif": "image/gif", ".webp": "image/webp", ".svg": "image/svg+xml" };
 var MAX_BYTES = 32 * 1024 * 1024;
 var startsWith = (bytes, signature, offset = 0) => signature.every((value, index) => bytes[offset + index] === value);
@@ -95,7 +93,7 @@ function createImageResolver(root, reporter, passDirectory = "pass --asset-dir")
 }
 var RENDER_PACKAGE = "@openpresentation/opf-render";
 var PPTX_PACKAGE = "@openpresentation/opf-pptx";
-var PEER_RANGES = { [RENDER_PACKAGE]: "^0.18.0", [PPTX_PACKAGE]: "^0.18.0" };
+var PEER_RANGES = { [RENDER_PACKAGE]: "^0.19.0", [PPTX_PACKAGE]: "^0.19.0" };
 var RENDER_EXTRAS = {
   /** The faces of the office pack, which the CLI and `convert` always load (every format). */
   fonts: ["@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"],
@@ -316,6 +314,26 @@ function deckStem(deck, input) {
   const slug = (value) => value.replace(/[^\p{L}\p{N}_-]+/gu, "-").replace(/-{2,}/g, "-").replace(/^-|-$/g, "");
   return clean(text(root.filename).trim().replace(/\.(pptx|pdf|png|svg)$/i, "")) || slug(text(root.name)) || stemOf(input);
 }
+function padNumber(value, largest) {
+  return String(value).padStart(String(largest).length, "0");
+}
+var PLACEHOLDER = /\{([^{}]*)\}/g;
+function outputKeys(output) {
+  return [...output.matchAll(PLACEHOLDER)].map((match) => match[1]);
+}
+function checkOutputPattern(output, perSlide) {
+  const keys = outputKeys(output);
+  if (!perSlide) {
+    if (keys.includes("n")) throw new OPFApiError(`{n} numbers the files of a .png or .svg output, one per slide; ${output} is a single file. Name the file without {n}.`, "invalid-option", { details: { path: output } });
+    return false;
+  }
+  const unknown = keys.find((key) => key !== "n");
+  if (unknown !== void 0) throw new OPFApiError(`Unknown {${unknown}} in the output ${output}: the only placeholder is {n}, the slide number.`, "invalid-option", { details: { path: output, key: unknown } });
+  return keys.length > 0;
+}
+function expandOutputPattern(output, slide, largest) {
+  return output.replace(PLACEHOLDER, () => padNumber(slide, largest));
+}
 async function checkDestinations(files, overwrite, flags = true) {
   for (const file of files) {
     try {
@@ -577,7 +595,7 @@ var MEDIA2 = { svg: "image/svg+xml", png: "image/png", pdf: "application/pdf", p
 async function runExport(presentation, options, ctx) {
   const { format, scale } = options;
   const reporter = ctx.reporter;
-  const catalogs = options.catalogs ?? DEFAULT_CATALOGS;
+  const catalogs = options.catalogs ?? defaultCatalogs();
   const date = checkDate(options.date);
   const renderer = ctx.renderer ?? await loadRenderer();
   const pptx = format === "pptx" ? ctx.pptx ?? await loadPptx() : void 0;
@@ -658,8 +676,8 @@ async function drawWith(presentation, handle, options, ctx, environment) {
       const svg = renderer.render.module.toSvg(deck, number, svgOptions);
       svgs.push({ slide: number, id: deck.slides[number - 1]?.id, svg });
     }
-    const width = Math.max(3, String(slideCount).length);
-    const name = (slide, extension) => `${stem}-${String(slide).padStart(width, "0")}.${extension}`;
+    const largest = Math.max(...selected);
+    const name = (slide, extension) => `${stem}-${padNumber(slide, largest)}.${extension}`;
     if (format === "pdf") {
       const mode = options.raster ? "raster" : "vector";
       const title = typeof deck.name === "string" ? deck.name : void 0;
@@ -719,7 +737,7 @@ async function runImport(bytes, options, reporter, loaded) {
 }
 
 // src/node/pipeline.ts
-var checkOptions = (catalogs) => ({ only: ["format", "references"], catalogs: catalogs ?? DEFAULT_CATALOGS });
+var checkOptions = (catalogs) => ({ only: ["format", "references"], catalogs: catalogs ?? defaultCatalogs() });
 var firstError = (findings) => {
   const first = findings.find((found) => found.severity === "error");
   return first ? `${first.message} [${first.ruleId}]` : "see findings.";
@@ -808,6 +826,7 @@ function targetOf(output, options, flags) {
   if (options.name !== void 0) throw invalid2(`${flags ? "--name" : "name"} is for output without a path; the output path names the file.`);
   if (path6.extname(output).toLowerCase() === ".zip") {
     if (format !== void 0 && format !== "png" && format !== "svg") throw invalid2(`A .zip output holds png or svg slides; ${formatLabel} ${format} is neither.`);
+    checkOutputPattern(output, false);
     return { kind: "export", format: format ?? "png", zip: true };
   }
   const exported = exportFormatOf(output);
@@ -815,6 +834,7 @@ function targetOf(output, options, flags) {
   const named = exported ?? deck;
   if (!named) throw invalid2(`${flags ? "opf convert" : "convert"} writes ${OUTPUTS} files; ${output} is none of them.`, { path: output });
   if (format !== void 0 && format !== named) throw invalid2(`${formatLabel} ${format} does not match the output ${output}, which is ${named}.`);
+  checkOutputPattern(output, exported === "png" || exported === "svg");
   return exported ? { kind: "export", format: exported, zip: false } : { kind: "deck", format: deck };
 }
 var EXPORT_ONLY = ["slides", "includeHidden", "paginate", "scale", "raster", "text", "charts", "provenance", "images", "date", "fonts", "assetDir"];
@@ -874,7 +894,7 @@ async function planConversion(input, output, options = {}, flags = false) {
   const source = sourceOf(input, flags);
   const target = targetOf(output, options, flags);
   checkApplicable(source, target, options, flags);
-  const catalogs = options.catalogs ?? DEFAULT_CATALOGS;
+  const catalogs = options.catalogs ?? defaultCatalogs();
   const ExportClass = target.kind === "export" ? OPFExportError : OPFApiError;
   const inputFile = typeof input === "string" ? input : void 0;
   let prepared;
@@ -932,12 +952,21 @@ async function planConversion(input, output, options = {}, flags = false) {
   if (output === void 0) return done(drawn.map((file) => ({ name: file.name, type: file.type, bytes: file.bytes, ...facts(file) })));
   const single = (file) => done([{ name: path6.basename(output), path: output, type: file.type, bytes: file.bytes, ...facts(file) }]);
   if (target.format === "pdf" || target.format === "pptx") return single(drawn[0]);
+  const largest = Math.max(...drawn.map((file) => file.slide ?? 0));
   const stem = path6.basename(output, path6.extname(output));
-  const numbered = (file) => `${stem}-${/-(\d+)\.(?:png|svg)$/.exec(file.name)?.[1] ?? String(file.slide).padStart(3, "0")}.${target.format}`;
+  const numbered = (file) => `${stem}-${padNumber(file.slide, largest)}.${target.format}`;
   if (target.zip) {
     const entries = drawn.map((file) => ({ name: numbered(file), bytes: file.bytes }));
     return done([{ name: path6.basename(output), path: output, type: ZIP_MEDIA, bytes: createZip(entries), entries: entries.map((entry) => entry.name).sort() }]);
   }
+  if (checkOutputPattern(output, true)) {
+    return done(
+      drawn.map((file) => {
+        const written = expandOutputPattern(output, file.slide, largest);
+        return { name: path6.basename(written), path: written, type: file.type, bytes: file.bytes, ...facts(file) };
+      })
+    );
+  }
   if (drawn.length === 1) return single(drawn[0]);
   const folder = path6.dirname(output);
   return done(drawn.map((file) => ({ name: numbered(file), path: path6.join(folder, numbered(file)), type: file.type, bytes: file.bytes, ...facts(file) })));
@@ -961,7 +990,7 @@ async function convertFiles(input, output, options = {}) {
   return { files: plan.files, findings: plan.findings, ...plan.imported?.signals ? { signals: plan.imported.signals } : {} };
 }
 async function openDeck(input, options = {}) {
-  const catalogs = options.catalogs ?? DEFAULT_CATALOGS;
+  const catalogs = options.catalogs ?? defaultCatalogs();
   if (input instanceof Uint8Array || input instanceof ArrayBuffer || typeof input === "string" && /\.pptx$/i.test(input)) {
     const bytes = typeof input === "string" ? await readInput(input) : input instanceof Uint8Array ? input : new Uint8Array(input);
     return (await inStep(OPFImportError, "import-failed", () => importPresentation(bytes, { catalogs }))).result.presentation;
@@ -980,7 +1009,7 @@ async function saveDeck(presentation, file, options = {}) {
   const format = deckFileFormat(file);
   if (!format) throw invalid2(`save writes ${DECKS} files; ${file} is none of them.${exportFormatOf(file) || /\.zip$/i.test(file) ? ` Export with convert(deck, "${file}").` : ""}`, { path: file });
   if (options.validate !== false) {
-    const report = validate(presentation, checkOptions(options.catalogs ?? DEFAULT_CATALOGS));
+    const report = validate(presentation, checkOptions(options.catalogs ?? defaultCatalogs()));
     if (!report.valid) throw new OPFValidationError(report);
   }
   const bytes = new TextEncoder().encode(deckText(presentation, format, options.schemaComment === true));
@@ -988,4 +1017,4 @@ async function saveDeck(presentation, file, options = {}) {
   return { path: file, format };
 }
 
-export { DEFAULT_CATALOGS, EXPORT_FORMATS, EXPORT_TEXT, PEER_RANGES, PPTX_PACKAGE, RENDER_EXTRAS, RENDER_PACKAGE, Reporter, VERSIONS, checkDate, checkDestinations, checkOptions, checkRenamedOptions, checkScale, convertFiles, createZip, deckFileFormat, deckStem, embeddedFor, exportFormatOf, finishReport, importPresentation, leaseSharedFonts, listFontDirectories, loadPptx, loadRenderer, locatePackage, missingPeerFrom, openDeck, planConversion, pointerOf, prepareExport, prepareFonts, reaches, readInput, reportThrown, resolveExportOptions, runExport, runImport, runPreparedExport, saveDeck, stemOf, writeFiles, writePlanned };
+export { EXPORT_FORMATS, EXPORT_TEXT, PEER_RANGES, PPTX_PACKAGE, RENDER_EXTRAS, RENDER_PACKAGE, Reporter, VERSIONS, checkDate, checkDestinations, checkOptions, checkOutputPattern, checkRenamedOptions, checkScale, convertFiles, createZip, deckFileFormat, deckStem, embeddedFor, exportFormatOf, finishReport, importPresentation, leaseSharedFonts, listFontDirectories, loadPptx, loadRenderer, locatePackage, missingPeerFrom, openDeck, padNumber, planConversion, pointerOf, prepareExport, prepareFonts, reaches, readInput, reportThrown, resolveExportOptions, runExport, runImport, runPreparedExport, saveDeck, stemOf, writeFiles, writePlanned };

package/dist/{chunk-PNINP5IF.js → chunk-YAHPQRVU.js}

@@ -1,4 +1,4 @@
-import { runText } from './chunk-TRELE6I6.js';
+import { runText } from './chunk-HBFRNOP4.js';
 
 // src/convert/text-lines.ts
 var LIST_PREFIX = /^([ \t]*)(?:([-*•+]|\d{1,3}[.)])[ \t]+)?/;