@openpresentation/opf 0.20.5 → 0.22.0

package/dist/{chunk-TCBEF5OY.js → chunk-2SENTA2R.js}

@@ -1,4 +1,4 @@
-import { validate } from './chunk-2M7U4WL3.js';
+import { validate } from './chunk-23MOKE4B.js';
 
 // src/convert/shared.ts
 var CONTENT_KEYS = ["text", "items", "bullets", "image", "video", "chart", "table", "code", "metric", "quote", "timeline"];

package/dist/{chunk-7PQZDC2H.js → chunk-3T7MNRBY.js}

@@ -1,4 +1,4 @@
-import { isRecord, same } from './chunk-TCBEF5OY.js';
+import { isRecord, same } from './chunk-2SENTA2R.js';
 import { parseDocument, YAMLMap, Scalar, stringify } from 'yaml';
 
 // src/not-checked.ts

package/dist/{chunk-VFMHM2IL.js → chunk-3UAVON3O.js}

@@ -1201,7 +1201,7 @@ var presentation = {
             "center",
             "right"
           ],
-          "description": "Default horizontal alignment for the title heading area in resolved layouts. Effective value: the slide's design, then the deck's design, then the theme's design.titleAlignment, then the layout record's design.titleAlignment, then the engine default."
+          "description": "Default horizontal alignment for the title heading area (the title and the tag) in resolved layouts. Effective value: the slide's design, then the deck's design, then the theme's design.titleAlignment, then the layout record's design.titleAlignment, then the engine default."
         },
         "contentAlignment": {
           "type": "string",
@@ -1210,7 +1210,7 @@ var presentation = {
             "center",
             "right"
           ],
-          "description": "Default horizontal alignment for body/content regions in resolved layouts. Effective value: the slide's design, then the deck's design, then the theme's design.contentAlignment, then the layout record's design.contentAlignment, then the engine default. A cover's tag and subtitle follow titleAlignment unless the slide's own design sets contentAlignment."
+          "description": "Default horizontal alignment for body/content regions in resolved layouts. Effective value: the slide's design, then the deck's design, then the theme's design.contentAlignment, then the layout record's design.contentAlignment, then the engine default. The tag follows titleAlignment (and a cover's subtitle with it) unless the slide's own design sets contentAlignment."
         },
         "contentBox": {
           "type": "boolean",
@@ -4653,6 +4653,21 @@ var presentation = {
             "Revenue grew from $12M in Q1 to $18M in Q2, with the steepest rise in the West region."
           ]
         },
+        "colors": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/ColorRef"
+          },
+          "minItems": 1,
+          "maxItems": 24,
+          "description": "Optional series colors, by position: entry i replaces palette color i, the color of series i (the i-th plotted value column), of slice or category i on a pie, doughnut, treemap or funnel chart, and of the i-th color a histogram, pareto, waterfall or box-and-whisker chart draws with. An entry is any ColorRef: a hex color, a color-scheme slot or role ('accent3', 'secondary') or a 'var:<id>' color variable; a scheme name keeps following the deck if its scheme changes, and is written to PowerPoint as a theme color. Positions past the last entry keep the deck palette (accent1 to accent6, then their tints). A color is kept at 3:1 contrast against the chart panel (a lighter or darker shade is used when it falls short) and 'chart.highlight' wins over it: highlighted marks take the primary color and the rest the muted neutral. A color that cannot be resolved falls back to the palette color for its position. Absent keeps the deck palette exactly.",
+          "examples": [
+            [
+              "accent3",
+              "#7B241C"
+            ]
+          ]
+        },
         "highlight": {
           "$ref": "#/$defs/ChartHighlight",
           "description": "Optional emphasis: the series and/or categories that carry the message. The engines draw the highlighted marks in the deck's primary (accent) color and every other mark in a muted neutral derived from the theme (a light grey on a light chart panel, a dim grey on a dark one); there is no color field. A mark is highlighted when its series OR its category is named. Absent keeps today's colors exactly. Supported on column, bar and line charts (series and categories; on a line a category highlight marks that category's points), pie and doughnut charts (categories, one per slice), and area, scatter and radar charts (series); the histogram, pareto, waterfall, funnel, treemap, box-and-whisker, map and combo constructs drop the option with a 'chart-option-adapted' diagnostic, as does a part the type cannot highlight. A name that matches no column or row label is a 'chart-highlight-unknown-name' error."
@@ -5395,6 +5410,10 @@ var presentation = {
           "$ref": "#/$defs/ColorRef",
           "description": "Default text color, overridden by individual rich run colors. Accepts a hex color, a color-scheme slot or role name, or a 'var:<id>' variable reference."
         },
+        "bold": {
+          "type": "boolean",
+          "description": "Bold cell text. Runs that set their own bold keep it; a number cell stays bold and still uses the cell's or column's number format."
+        },
         "align": {
           "type": "string",
           "enum": [
@@ -8551,6 +8570,13 @@ var finding = {
         "params": {
           "type": "object",
           "additionalProperties": true
+        },
+        "alternatives": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "Present when the issue is the best match of a oneOf or anyOf: one line per other form the value was checked against and did not fit, such as `string: must be string`."
         }
       }
     },

package/dist/{chunk-IDMQWS6O.js → chunk-7XNAMCGT.js}

@@ -1,9 +1,9 @@
-import { NOT_CHECKED, Ctx } from './chunk-7PQZDC2H.js';
-import { sortPresentationKeys } from './chunk-S4FR7ATF.js';
-import { same } from './chunk-TCBEF5OY.js';
-import { validate } from './chunk-2M7U4WL3.js';
-import { checkCatalogsOption } from './chunk-XAYMPBNE.js';
-import { presentation } from './chunk-VFMHM2IL.js';
+import { NOT_CHECKED, Ctx } from './chunk-3T7MNRBY.js';
+import { sortPresentationKeys } from './chunk-X3PQMMAY.js';
+import { same } from './chunk-2SENTA2R.js';
+import { validate } from './chunk-23MOKE4B.js';
+import { checkCatalogsOption } from './chunk-VKNFZEMG.js';
+import { presentation } from './chunk-3UAVON3O.js';
 import { Parser, parseDocument, isMap, Document, visit, isScalar, isAlias, isSeq } from 'yaml';
 
 var MAX_ALIAS_COUNT = 100;

package/dist/{chunk-URUNMZFO.js → chunk-BULGAKBY.js}

@@ -1,5 +1,5 @@
-import { jsonEqual, formatPointer } from './chunk-YOLDSF7U.js';
-import { annotationText } from './chunk-XAYMPBNE.js';
+import { jsonEqual, formatPointer } from './chunk-YSJRBRHB.js';
+import { annotationText } from './chunk-VKNFZEMG.js';
 
 // src/diff-match.ts
 var DEFAULT_MATCH_THRESHOLD = 0.5;

package/dist/{chunk-WD4W7KKK.js → chunk-DY7H4RG6.js}

@@ -1,11 +1,11 @@
-import { defaultCatalogs } from './chunk-OIGCC6VA.js';
-import { OPFApiError, parseSlideSelection, OPFExportError, asApiError, OPFImportError } from './chunk-52GKVP3I.js';
-import { deckFormatOf, readDeckReport, stringify } from './chunk-5SQ6CIWR.js';
-import { paginate } from './chunk-DYGYMBBW.js';
-import { validate, OPFValidationError } from './chunk-2M7U4WL3.js';
-import { stat, readdir, lstat, mkdir, open, rename, link, unlink, readFile } from 'fs/promises';
+import { defaultCatalogs } from './chunk-MG34DCDB.js';
+import { localAssetSources, OPFApiError, parseSlideSelection, OPFExportError, asApiError, OPFImportError } from './chunk-MAJHCGOW.js';
+import { deckFormatOf, readDeckReport, stringify } from './chunk-MLMTXXM4.js';
+import { paginate } from './chunk-YUIEWE5B.js';
+import { validate, OPFValidationError } from './chunk-23MOKE4B.js';
+import { link, stat, readdir, lstat, readFile, open, unlink, mkdir, rename } from 'fs/promises';
 import path6 from 'path';
-import { readFileSync, realpathSync, statSync } from 'fs';
+import { readFileSync, statSync, realpathSync } from 'fs';
 import { pathToFileURL, fileURLToPath } from 'url';
 import { createRequire } from 'module';
 import { randomUUID } from 'crypto';
@@ -74,6 +74,11 @@ function createImageResolver(root, reporter, passDirectory = "pass --asset-dir")
     return outcome;
   }
   return {
+    /** The reason a local source cannot be read (`missing`: no such file; `blocked`: outside the folder, not an image, too large), or undefined when it can, or is not a local file. */
+    check: (source) => {
+      const outcome = read(source);
+      return "problem" in outcome ? outcome : void 0;
+    },
     /** opf-render: a data URI string, or null for the placeholder (a missing file is reported by the renderer as unresolved-asset). */
     forSvg: (source, context) => {
       if (!source) return null;
@@ -91,6 +96,25 @@ function createImageResolver(root, reporter, passDirectory = "pass --asset-dir")
     }
   };
 }
+function pointerToString(value, source, pointer = "") {
+  if (value === source) return pointer;
+  if (value === null || typeof value !== "object") return void 0;
+  for (const [key, child] of Object.entries(value)) {
+    const found = pointerToString(child, source, `${pointer}/${key.replaceAll("~", "~0").replaceAll("/", "~1")}`);
+    if (found !== void 0) return found;
+  }
+  return void 0;
+}
+function localAssetProblems(deck, root) {
+  const resolver = createImageResolver(root, { add() {
+  } });
+  const problems = [];
+  for (const source of localAssetSources(deck)) {
+    const found = resolver.check(source);
+    if (found) problems.push({ path: pointerToString(deck, source) ?? "", source, ...found });
+  }
+  return problems;
+}
 var RENDER_PACKAGE = "@openpresentation/opf-render";
 var PPTX_PACKAGE = "@openpresentation/opf-pptx";
 var PEER_RANGES = { [RENDER_PACKAGE]: "^0.20.0", [PPTX_PACKAGE]: "^0.20.0" };
@@ -348,6 +372,25 @@ async function checkDestinations(files, overwrite, flags = true) {
     }
   }
 }
+var NO_HARD_LINKS = /* @__PURE__ */ new Set(["EPERM", "ENOTSUP", "EOPNOTSUPP", "ENOSYS", "EXDEV"]);
+async function publishNew(temporary, output, publish = link) {
+  try {
+    await publish(temporary, output);
+    return;
+  } catch (error) {
+    if (!NO_HARD_LINKS.has(error.code ?? "")) throw error;
+  }
+  const bytes = await readFile(temporary);
+  const handle = await open(output, "wx");
+  try {
+    await handle.writeFile(bytes);
+    await handle.close();
+  } catch (error) {
+    await handle.close().catch(() => void 0);
+    await unlink(output).catch(() => void 0);
+    throw error;
+  }
+}
 async function writeFiles(files, overwrite, flags = true) {
   const unique = new Set(files.map((entry) => path6.resolve(entry.file)));
   if (unique.size !== files.length) throw new OPFApiError("Two outputs would write the same file.", "invalid-option");
@@ -372,7 +415,7 @@ async function writeFiles(files, overwrite, flags = true) {
         item.temporary = "";
       } else {
         try {
-          await link(item.temporary, item.output);
+          await publishNew(item.temporary, item.output);
         } catch (error) {
           if (error.code === "EEXIST") throw outputExists(item.output, flags);
           throw error;
@@ -438,14 +481,14 @@ var Reporter = class {
       help: HELP[code] ?? "",
       ...Object.fromEntries(Object.entries(details).filter(([, value]) => value !== void 0))
     };
-    const key = JSON.stringify([entry.ruleId, entry.path, entry.message]);
+    const key = JSON.stringify([entry.ruleId, entry.path, entry.message, details]);
     if (this.seen.has(key)) return;
     this.seen.add(key);
     this.findings.push(entry);
   }
   /** Add a finding as the library made it (the `findings` of a thrown OPFRenderError, OPFPptxError or core validation error). Identical entries are kept once. */
   addFinding(finding) {
-    const key = JSON.stringify([finding.ruleId, finding.path, finding.message]);
+    const key = JSON.stringify(finding);
     if (this.seen.has(key)) return;
     this.seen.add(key);
     this.findings.push(finding);
@@ -1035,4 +1078,4 @@ async function saveDeck(presentation, file, options = {}) {
   return { path: file, format };
 }
 
-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 };
+export { EXPORT_FORMATS, EXPORT_TEXT, PEER_RANGES, PPTX_PACKAGE, RENDER_EXTRAS, RENDER_PACKAGE, Reporter, VERSIONS, assetRoot, checkDate, checkDestinations, checkOptions, checkOutputPattern, checkRenamedOptions, checkScale, convertFiles, createZip, deckFileFormat, deckStem, embeddedFor, exportFormatOf, finishReport, importPresentation, leaseSharedFonts, listFontDirectories, loadPptx, loadRenderer, localAssetProblems, locatePackage, missingPeerFrom, openDeck, padNumber, planConversion, pointerOf, prepareExport, prepareFonts, publishNew, reaches, readInput, reportThrown, resolveExportOptions, runExport, runImport, runPreparedExport, saveDeck, stemOf, writeFiles, writePlanned };

package/dist/{chunk-V66KJA3H.js → chunk-KUNXFN7B.js}

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

package/dist/{chunk-52GKVP3I.js → chunk-MAJHCGOW.js}

@@ -1,7 +1,7 @@
-import { OPFDataImportError, parseTabularData } from './chunk-TZ5IZETE.js';
-import { applyPatchWithInverse } from './chunk-YOLDSF7U.js';
-import { validate, OPFValidationError } from './chunk-2M7U4WL3.js';
-import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN, isRecord, visitContentPayloads, annotationText, listVariables, resolveVariables, LOGO_SHAPES, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-XAYMPBNE.js';
+import { OPFDataImportError, parseTabularData } from './chunk-SPCONMIY.js';
+import { applyPatchWithInverse } from './chunk-YSJRBRHB.js';
+import { validate, OPFValidationError } from './chunk-23MOKE4B.js';
+import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN, isRecord, visitContentPayloads, annotationText, listVariables, resolveVariables, LOGO_SHAPES, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-VKNFZEMG.js';
 
 // src/api-errors.ts
 var OPFApiError = class extends Error {
@@ -429,6 +429,14 @@ function visitRuns(value, visit) {
   }
 }
 function stats(presentation2, options = {}) {
+  return compute(presentation2, options);
+}
+function localAssetSources(presentation2) {
+  const found = /* @__PURE__ */ new Set();
+  compute(presentation2, {}, (src) => found.add(src));
+  return [...found];
+}
+function compute(presentation2, options, onFile) {
   const catalogs = { catalogs: checkCatalogsOption(options.catalogs, "stats") };
   if (!isRecord(presentation2)) throw new TypeError("stats needs a presentation object.");
   const deck = presentation2;
@@ -439,9 +447,14 @@ function stats(presentation2, options = {}) {
   const registry = isRecord(deck.assets) ? deck.assets : {};
   const uses = { total: 0, references: 0, embedded: 0, files: 0, remote: 0 };
   let embeddedTotal = 0;
-  const useAsset = (asset) => {
+  const useAsset = (asset, video = false) => {
     const src = srcOf(asset);
     if (src === void 0) return;
+    if (onFile && !video) {
+      let source = src;
+      for (let hop = 0; source !== void 0 && assetForm(source) === "reference" && hop < 8; hop++) source = srcOf(registry[source.slice("asset:".length)]);
+      if (source !== void 0 && assetForm(source) === "file" && !source.includes("{{")) onFile(source);
+    }
     const form = assetForm(src);
     uses.total++;
     uses[form === "reference" ? "references" : form === "embedded" ? "embedded" : form === "remote" ? "remote" : "files"]++;
@@ -562,7 +575,7 @@ function stats(presentation2, options = {}) {
   const datasetUse = /* @__PURE__ */ new Map();
   const payloadCounts = { text: 0, items: 0, bullets: 0, quote: 0, metric: 0, code: 0, timeline: 0, chart: 0, table: 0, image: 0, video: 0, blocks: 0, regions: 0, groups: 0, maxDepth: 0 };
   const layouts = /* @__PURE__ */ new Map(), chartTypes = /* @__PURE__ */ new Map(), extensions = /* @__PURE__ */ new Set();
-  const chartData = { inline: 0, dataset: 0, source: 0 };
+  const chartData = { inline: 0, dataset: 0, withSource: 0 };
   const tableItems = [];
   let tableRows = 0, tableColumns = 0, datasetBackedTables = 0, chartTotal = 0, captions = 0;
   const hidden = [], withoutNotes = [], sections = [];
@@ -641,7 +654,7 @@ function stats(presentation2, options = {}) {
       }
       if (node.image !== void 0) slideImages += contentImage(node.image);
       if (node.video !== void 0) {
-        useAsset(node.video);
+        useAsset(node.video, true);
         images.videos++;
       }
       if (isRecord(node.chart)) {
@@ -654,10 +667,7 @@ function stats(presentation2, options = {}) {
             chartData.dataset++;
             bump(datasetUse, data.dataset);
           } else if (Array.isArray(data.columns) || Array.isArray(data.rows)) chartData.inline++;
-          else if (typeof data.src === "string") {
-            chartData.source++;
-            useAsset(data.src);
-          }
+          if (isRecord(data.source)) chartData.withSource++;
         }
       }
       if (isRecord(node.table)) {
@@ -920,4 +930,4 @@ function summarize(decks) {
   return [...merged.values()];
 }
 
-export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, asApiError, copySlides, edit, embed, fill, fillRecords, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog };
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, asApiError, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog };

package/dist/{chunk-OIGCC6VA.js → chunk-MG34DCDB.js}

@@ -1,5 +1,5 @@
-import { OPFApiError } from './chunk-52GKVP3I.js';
-import { CATALOG_SCHEMA } from './chunk-2M7U4WL3.js';
+import { OPFApiError } from './chunk-MAJHCGOW.js';
+import { CATALOG_SCHEMA } from './chunk-23MOKE4B.js';
 import { CATALOG_SCHEMA as CATALOG_SCHEMA$1, gallery } from '@openpresentation/gallery';
 
 function galleryMismatch(declared, reads = CATALOG_SCHEMA) {

package/dist/{chunk-5SQ6CIWR.js → chunk-MLMTXXM4.js}

@@ -1,8 +1,8 @@
-import { fromMarkdown, toMarkdown } from './chunk-Z75YB54S.js';
-import { fromYaml, toYaml } from './chunk-IDMQWS6O.js';
-import { NOT_CHECKED } from './chunk-7PQZDC2H.js';
-import { parseSource, validate, OPFValidationError } from './chunk-2M7U4WL3.js';
-import { checkCatalogsOption } from './chunk-XAYMPBNE.js';
+import { fromMarkdown, toMarkdown } from './chunk-SBWIZSPB.js';
+import { fromYaml, toYaml } from './chunk-7XNAMCGT.js';
+import { NOT_CHECKED } from './chunk-3T7MNRBY.js';
+import { parseSource, validate, OPFValidationError } from './chunk-23MOKE4B.js';
+import { checkCatalogsOption } from './chunk-VKNFZEMG.js';
 
 // src/deck-report.ts
 var DECK_FORMATS = ["json", "yaml", "markdown"];

package/dist/{chunk-Z75YB54S.js → chunk-SBWIZSPB.js}

@@ -1,8 +1,8 @@
-import { Ctx, splitLines, lineRange, readYamlMapping, NOT_CHECKED, OPFMarkdownError, writeYaml, readCsv, DECIMAL, csvField, scalarText } from './chunk-7PQZDC2H.js';
-import { parseQuoteLines, levelsFromIndents, parseCodeFence, splitWhen, fenceCode } from './chunk-V66KJA3H.js';
-import { same, isRecord, runText, isPlainRun, FORMATTING } from './chunk-TCBEF5OY.js';
-import { validate } from './chunk-2M7U4WL3.js';
-import { checkCatalogsOption, PROMOTED_REGION_KEY } from './chunk-XAYMPBNE.js';
+import { Ctx, splitLines, lineRange, readYamlMapping, NOT_CHECKED, OPFMarkdownError, writeYaml, readCsv, DECIMAL, csvField, scalarText } from './chunk-3T7MNRBY.js';
+import { parseQuoteLines, levelsFromIndents, parseCodeFence, splitWhen, fenceCode } from './chunk-KUNXFN7B.js';
+import { same, isRecord, runText, isPlainRun, FORMATTING } from './chunk-2SENTA2R.js';
+import { validate } from './chunk-23MOKE4B.js';
+import { checkCatalogsOption, PROMOTED_REGION_KEY } from './chunk-VKNFZEMG.js';
 
 // src/markdown/canon.ts
 var FORMAT_KEYS = FORMATTING;

package/dist/{chunk-TZ5IZETE.js → chunk-SPCONMIY.js}

@@ -1,4 +1,4 @@
-import { chartNumber } from './chunk-XAYMPBNE.js';
+import { chartNumber } from './chunk-VKNFZEMG.js';
 
 // src/data.ts
 var OPFDataImportError = class extends Error {