@openpresentation/opf 0.26.4 → 0.26.5

package/dist/{chunk-XFOOKVRI.js → chunk-CIWC7DRZ.js}

@@ -22,8 +22,8 @@ var catalogSchemaNames = {
 };
 
 // src/annotation-validation.ts
-var issue = (path, message, params) => ({ path, message, keyword: "opf", schemaPath: "#/x-opf-semantics", params });
-var pointer = (dotted) => `/${dotted.split(".").map((part) => part.replaceAll("~", "~0").replaceAll("/", "~1")).join("/")}`;
+var issue = (path, message, params2) => ({ path, message, keyword: "opf", schemaPath: "#/x-opf-semantics", params: params2 });
+var pointer = (dotted2) => `/${dotted2.split(".").map((part) => part.replaceAll("~", "~0").replaceAll("/", "~1")).join("/")}`;
 function markedRuns(value) {
   if (!Array.isArray(value)) return [];
   return value.flatMap((run, index) => isRecord(run) && (run.cite !== void 0 || run.footnote !== void 0) ? [index] : []);
@@ -41,9 +41,9 @@ function annotationIssues(value) {
   const unsupported = (runs, path, where) => {
     for (const runIndex of markedRuns(runs)) issues.push(issue(`${path}/${runIndex}`, `cite and footnote are not supported in ${where}; markers are drawn only in the slide title, subtitle and tag, text, bullets, list items and quote text`, { code: "cite-unsupported-location" }));
   };
-  const cell = (entry, path) => {
-    if (Array.isArray(entry)) unsupported(entry, path, "table cells");
-    else if (isRecord(entry) && Array.isArray(entry.value)) unsupported(entry.value, pathFor(path, "value"), "table cells");
+  const cell = (entry2, path) => {
+    if (Array.isArray(entry2)) unsupported(entry2, path, "table cells");
+    else if (isRecord(entry2) && Array.isArray(entry2.value)) unsupported(entry2.value, pathFor(path, "value"), "table cells");
   };
   const payload = (node, path) => {
     if (isRecord(node.table)) {
@@ -52,8 +52,8 @@ function annotationIssues(value) {
         cell(column, `${pathFor(tablePath, "columns")}/${index}`);
       });
       if (Array.isArray(table.rows)) table.rows.forEach((row, rowIndex) => {
-        if (Array.isArray(row)) row.forEach((entry, cellIndex) => {
-          cell(entry, `${pathFor(tablePath, "rows")}/${rowIndex}/${cellIndex}`);
+        if (Array.isArray(row)) row.forEach((entry2, cellIndex) => {
+          cell(entry2, `${pathFor(tablePath, "rows")}/${rowIndex}/${cellIndex}`);
         });
       });
     }
@@ -68,15 +68,15 @@ function annotationIssues(value) {
     const slidePath = `/slides/${index}`;
     payload(slide, slidePath);
     visitContentPayloads(slide, slidePath, payload);
-    walkCitationRuns(slide, `slides.${index}`, (entry) => {
-      const runPath = pointer(entry.path);
-      const cite = entry.run.cite;
+    walkCitationRuns(slide, `slides.${index}`, (entry2) => {
+      const runPath = pointer(entry2.path);
+      const cite = entry2.run.cite;
       if (typeof cite === "string") {
         if (!ids.has(cite)) issues.push(issue(`${runPath}/cite`, `unknown reference '${cite}'; add it to the top-level references list`, { code: "cite-unknown-reference", id: cite }));
       } else if (Array.isArray(cite)) cite.forEach((id, position) => {
         if (typeof id === "string" && !ids.has(id)) issues.push(issue(`${runPath}/cite/${position}`, `unknown reference '${id}'; add it to the top-level references list`, { code: "cite-unknown-reference", id }));
       });
-      if (Array.isArray(entry.footnote)) unsupported(entry.footnote, `${runPath}/footnote`, "footnote text");
+      if (Array.isArray(entry2.footnote)) unsupported(entry2.footnote, `${runPath}/footnote`, "footnote text");
     });
   });
   return issues;
@@ -144,7 +144,7 @@ function bestMatchErrors(ajv2, rootId, errors) {
     if (analysis) analyses.push(analysis);
   }
   if (!analyses.length) return errors;
-  const within = (inner, other) => other !== inner && [...inner.span].every((entry) => other.span.has(entry)) && (other.span.size > inner.span.size || errors.indexOf(other.union) > errors.indexOf(inner.union));
+  const within = (inner, other) => other !== inner && [...inner.span].every((entry2) => other.span.has(entry2)) && (other.span.size > inner.span.size || errors.indexOf(other.union) > errors.indexOf(inner.union));
   const outer = analyses.filter((analysis) => !analyses.some((other) => within(analysis, other)));
   const replaced = new Map(outer.map((analysis) => [analysis.union, analysis]));
   const drop = new Set(outer.flatMap((analysis) => [...analysis.span]));
@@ -213,18 +213,18 @@ function rememberValidationDefinition(issue2, parentSchema, keyword) {
   if (!parentSchema || typeof parentSchema !== "object") return;
   if (!schemaLocations) {
     schemaLocations = /* @__PURE__ */ new WeakMap();
-    for (const entry of schemaEntries) {
+    for (const entry2 of schemaEntries) {
       const stack = [
-        { value: entry.schema, pointer: "" }
+        { value: entry2.schema, pointer: "" }
       ];
       while (stack.length) {
         const current = stack.pop();
         if (!current?.value || typeof current.value !== "object")
           continue;
         schemaLocations.set(current.value, {
-          schemaName: entry.name,
+          schemaName: entry2.name,
           pointer: current.pointer,
-          uri: `${entry.schema.$id}#${current.pointer}`
+          uri: `${entry2.schema.$id}#${current.pointer}`
         });
         for (const [key2, value] of Object.entries(current.value)) {
           const segment = key2.replaceAll("~", "~0").replaceAll("/", "~1");
@@ -379,13 +379,13 @@ function toIssue(error) {
   rememberValidationDefinition(issue2, error.parentSchema, error.keyword);
   return issue2;
 }
-function semanticIssue(path, message, params = {}) {
+function semanticIssue(path, message, params2 = {}) {
   return {
     path,
     message,
     keyword: "opf",
     schemaPath: "#/x-opf-semantics",
-    params
+    params: params2
   };
 }
 function hasOwn(value, key2) {
@@ -414,22 +414,22 @@ function inferredKinds(value) {
   if (hasOwn(value, "timeline")) kinds.push("timeline");
   return kinds;
 }
-function isImplicitBlocksComposition(value, inferred, options) {
-  if (options.slideRoot !== true || hasOwn(value, "blocks")) {
+function isImplicitBlocksComposition(value, inferred, options2) {
+  if (options2.slideRoot !== true || hasOwn(value, "blocks")) {
     return false;
   }
   return inferred.length > 1;
 }
-function validateContentPayload(value, path, options = {}) {
+function validateContentPayload(value, path, options2 = {}) {
   const issues = [];
   const explicitType = value.type;
   const payloadFields = presentFields(value, rootPayloadFields);
   const hasBlocks = hasOwn(value, "blocks");
-  const captionIssue = (reason, params = {}) => semanticIssue(pathFor(path, "caption"), `caption is only valid on an image, chart, table or video payload; ${reason}`, { code: "caption-unsupported-payload", ...params });
-  const imageOptionIssues = (reason, params = {}) => {
-    for (const field of imageOptionFields) if (hasOwn(value, field)) issues.push(semanticIssue(pathFor(path, field), `${field} is only valid on an image payload; ${reason}`, { code: "image-option-unsupported-payload", field, ...params }));
+  const captionIssue = (reason, params2 = {}) => semanticIssue(pathFor(path, "caption"), `caption is only valid on an image, chart, table or video payload; ${reason}`, { code: "caption-unsupported-payload", ...params2 });
+  const imageOptionIssues = (reason, params2 = {}) => {
+    for (const field of imageOptionFields) if (hasOwn(value, field)) issues.push(semanticIssue(pathFor(path, field), `${field} is only valid on an image payload; ${reason}`, { code: "image-option-unsupported-payload", field, ...params2 }));
   };
-  if (hasOwn(value, "placement") && !options.topLevel && !hasBlocks && explicitType !== "group" && inferredKinds(value).includes("image")) {
+  if (hasOwn(value, "placement") && !options2.topLevel && !hasBlocks && explicitType !== "group" && inferredKinds(value).includes("image")) {
     issues.push(semanticIssue(pathFor(path, "placement"), "placement is only valid on a top-level block (slides.N.blocks.I); a block inside a group or a promoted region cannot bleed to a slide edge", { code: "image-placement-invalid" }));
   }
   if (hasBlocks || explicitType === "group") {
@@ -438,11 +438,11 @@ function validateContentPayload(value, path, options = {}) {
     if (explicitType !== void 0 && explicitType !== "group") issues.push(semanticIssue(path, "a group must use type 'group' or omit type"));
     const incompatible2 = payloadFields.filter((field) => field !== "blocks" && field !== "type");
     if (incompatible2.length) issues.push(semanticIssue(path, "blocks cannot be mixed with leaf payload fields", { fields: incompatible2 }));
-    if (!Array.isArray(value.blocks) || value.blocks.length === 0 && !options.slideRoot) issues.push(semanticIssue(pathFor(path, "blocks"), "a group requires at least one block"));
+    if (!Array.isArray(value.blocks) || value.blocks.length === 0 && !options2.slideRoot) issues.push(semanticIssue(pathFor(path, "blocks"), "a group requires at least one block"));
     if (Array.isArray(value.blocks)) value.blocks.forEach((block, index) => {
-      if (isRecord(block)) issues.push(...validateContentPayload(block, `${pathFor(path, "blocks")}/${index}`, { topLevel: options.slideRoot === true }));
+      if (isRecord(block)) issues.push(...validateContentPayload(block, `${pathFor(path, "blocks")}/${index}`, { topLevel: options2.slideRoot === true }));
     });
-    if (options.slideRoot && Array.isArray(value.blocks)) {
+    if (options2.slideRoot && Array.isArray(value.blocks)) {
       const edges = /* @__PURE__ */ new Map();
       value.blocks.forEach((block, index) => {
         const edge = isRecord(block) && isRecord(block.placement) ? block.placement.edge : void 0;
@@ -453,7 +453,7 @@ function validateContentPayload(value, path, options = {}) {
     }
     return issues;
   }
-  if (hasOwn(value, "composition") && !options.slideRoot) issues.push(semanticIssue(pathFor(path, "composition"), "composition is only valid on a group containing blocks"));
+  if (hasOwn(value, "composition") && !options2.slideRoot) issues.push(semanticIssue(pathFor(path, "composition"), "composition is only valid on a group containing blocks"));
   if (explicitType !== void 0 && !isContentKind(explicitType)) {
     return issues;
   }
@@ -468,7 +468,7 @@ function validateContentPayload(value, path, options = {}) {
     return issues;
   }
   if (!kind && inferred.length > 1) {
-    if (isImplicitBlocksComposition(value, inferred, options)) {
+    if (isImplicitBlocksComposition(value, inferred, options2)) {
       if (hasOwn(value, "caption")) issues.push(captionIssue("a slide root with several payloads cannot carry one; put the caption on a block", { inferredTypes: inferred }));
       return issues;
     }
@@ -577,22 +577,22 @@ function deckMetadataIssues(value) {
   const issues = [];
   const entries = (key2) => {
     const field = value[key2];
-    if (Array.isArray(field)) return field.flatMap((entry, index) => isRecord(entry) ? [{ entry, path: `/${key2}/${index}` }] : []);
+    if (Array.isArray(field)) return field.flatMap((entry2, index) => isRecord(entry2) ? [{ entry: entry2, path: `/${key2}/${index}` }] : []);
     return isRecord(field) ? [{ entry: field, path: `/${key2}` }] : [];
   };
   const organizationIds = /* @__PURE__ */ new Set();
   for (const key2 of ["organization", "speaker"]) {
     const seen = /* @__PURE__ */ new Set();
-    for (const { entry, path } of entries(key2)) {
-      if (typeof entry.id !== "string") continue;
-      if (seen.has(entry.id)) issues.push(semanticIssue(`${path}/id`, `${key2} ids must be unique within a presentation`, { id: entry.id }));
-      seen.add(entry.id);
-      if (key2 === "organization") organizationIds.add(entry.id);
+    for (const { entry: entry2, path } of entries(key2)) {
+      if (typeof entry2.id !== "string") continue;
+      if (seen.has(entry2.id)) issues.push(semanticIssue(`${path}/id`, `${key2} ids must be unique within a presentation`, { id: entry2.id }));
+      seen.add(entry2.id);
+      if (key2 === "organization") organizationIds.add(entry2.id);
     }
   }
-  for (const { entry, path } of entries("speaker")) {
-    if (typeof entry.organizationId === "string" && !organizationIds.has(entry.organizationId)) {
-      issues.push(semanticIssue(`${path}/organizationId`, `organizationId '${entry.organizationId}' names no organization in the presentation; use the id of an entry in organization`, { id: entry.organizationId }));
+  for (const { entry: entry2, path } of entries("speaker")) {
+    if (typeof entry2.organizationId === "string" && !organizationIds.has(entry2.organizationId)) {
+      issues.push(semanticIssue(`${path}/organizationId`, `organizationId '${entry2.organizationId}' names no organization in the presentation; use the id of an entry in organization`, { id: entry2.organizationId }));
     }
   }
   return issues;
@@ -659,11 +659,11 @@ function slideThemeDimensionsWarnings(document, slide, index, catalogs) {
   const slidePath = `/slides/${index}`;
   const slideDesign = isRecord(slide.design) ? slide.design : void 0;
   if (!slideDesign || typeof slideDesign.theme !== "string") return [];
-  const options = { catalogs: catalogs ?? [] };
-  const slideTheme = resolveDesignRecords(document, index, options);
+  const options2 = { catalogs: catalogs ?? [] };
+  const slideTheme = resolveDesignRecords(document, index, options2);
   if (slideTheme.diagnostics.some((diagnostic) => diagnostic.kind === "themes") || slideTheme.theme.dimensions === void 0) return [];
   const deckDesign = isRecord(document.design) ? document.design : {};
-  const deckDimensions = deckDesign.dimensions ?? resolveDesignRecords(document, void 0, options).theme.dimensions;
+  const deckDimensions = deckDesign.dimensions ?? resolveDesignRecords(document, void 0, options2).theme.dimensions;
   const slideSize = canvasSize(slideTheme.theme.dimensions);
   const deckSize = canvasSize(deckDimensions);
   if (slideSize === deckSize) return [];
@@ -790,28 +790,28 @@ function variableReferenceWarnings(value) {
   }
   const variables = isRecord(value.variables) ? value.variables : {};
   const issues = [];
-  const colorRef = (entry, path) => {
-    if (typeof entry !== "string" || !entry.startsWith("var:")) return;
-    const id = entry.slice("var:".length);
+  const colorRef = (entry2, path) => {
+    if (typeof entry2 !== "string" || !entry2.startsWith("var:")) return;
+    const id = entry2.slice("var:".length);
     if (!variableIdPattern.test(id) || hasOwn(variables, id)) return;
     issues.push(semanticIssue(path, `unknown variable '${id}'; declare it in the top-level variables map`, { id, code: "variable-reference-unknown" }));
   };
-  const runColor = (entry, path) => {
-    if (typeof entry !== "string") return;
-    if (hexColorPattern.test(entry) || schemeColorNames.has(entry)) return;
-    if (entry.startsWith("var:") && variableIdPattern.test(entry.slice("var:".length))) {
-      colorRef(entry, path);
+  const runColor = (entry2, path) => {
+    if (typeof entry2 !== "string") return;
+    if (hexColorPattern.test(entry2) || schemeColorNames.has(entry2)) return;
+    if (entry2.startsWith("var:") && variableIdPattern.test(entry2.slice("var:".length))) {
+      colorRef(entry2, path);
       return;
     }
     issues.push(semanticIssue(
       path,
-      `run color '${entry}' is not a hex color, a color-scheme name, or a 'var:' reference; renderers fall back to the theme color`,
-      { color: entry, code: "run-color-unrecognized" }
+      `run color '${entry2}' is not a hex color, a color-scheme name, or a 'var:' reference; renderers fall back to the theme color`,
+      { color: entry2, code: "run-color-unrecognized" }
     ));
   };
-  const richText = (entry, path) => {
-    if (!Array.isArray(entry)) return;
-    entry.forEach((run, index) => {
+  const richText = (entry2, path) => {
+    if (!Array.isArray(entry2)) return;
+    entry2.forEach((run, index) => {
       if (isRecord(run)) runColor(run.color, `${path}/${index}/color`);
     });
   };
@@ -855,15 +855,15 @@ function variableReferenceWarnings(value) {
   };
   const textEntries = (entries, path) => {
     if (!Array.isArray(entries)) return;
-    entries.forEach((entry, index) => {
+    entries.forEach((entry2, index) => {
       const entryPath = `${path}/${index}`;
-      if (Array.isArray(entry)) {
-        richText(entry, entryPath);
+      if (Array.isArray(entry2)) {
+        richText(entry2, entryPath);
         return;
       }
-      if (!isRecord(entry)) return;
-      richText(entry.text, pathFor(entryPath, "text"));
-      richText(entry.description, pathFor(entryPath, "description"));
+      if (!isRecord(entry2)) return;
+      richText(entry2.text, pathFor(entryPath, "text"));
+      richText(entry2.description, pathFor(entryPath, "description"));
     });
   };
   const backgroundColors = (background, path) => {
@@ -919,9 +919,9 @@ function presentationReferenceWarnings(value, catalogs) {
     numberingWarnings(slide, slidePath);
     visitContentPayloads(slide, slidePath, numberingWarnings);
     const highlightWarnings = (payload, path) => {
-      const code = payload.code;
-      if (!isRecord(code) || !Array.isArray(code.highlight) || typeof code.source !== "string") return;
-      for (const finding2 of codeHighlightLines(code.highlight, code.source).issues) {
+      const code2 = payload.code;
+      if (!isRecord(code2) || !Array.isArray(code2.highlight) || typeof code2.source !== "string") return;
+      for (const finding2 of codeHighlightLines(code2.highlight, code2.source).issues) {
         if (finding2.code === "code-highlight-invalid") continue;
         issues.push(semanticIssue(pathFor(pathFor(pathFor(path, "code"), "highlight"), String(finding2.index)), finding2.message, { code: finding2.code }));
       }
@@ -958,23 +958,23 @@ function contentDepthIssues(value) {
     for (const key2 of promotedRegionKeys) if (hasOwn(slide, key2)) stack.push({ value: slide[key2], path: `/slides/${index}/${key2}`, depth: 0, ancestors: [] });
   });
   while (stack.length) {
-    const entry = stack.pop();
-    if (!isRecord(entry.value) || !Array.isArray(entry.value.blocks)) continue;
-    if (entry.ancestors.includes(entry.value) || entry.depth >= MAX_COMPOSITION_DEPTH) return [semanticIssue(entry.path, `content groups must be acyclic and nest at most ${MAX_COMPOSITION_DEPTH} levels`)];
-    const ancestors = [...entry.ancestors, entry.value];
-    entry.value.blocks.forEach((block, i) => {
-      stack.push({ value: block, path: `${entry.path}/blocks/${i}`, depth: entry.depth + 1, ancestors });
+    const entry2 = stack.pop();
+    if (!isRecord(entry2.value) || !Array.isArray(entry2.value.blocks)) continue;
+    if (entry2.ancestors.includes(entry2.value) || entry2.depth >= MAX_COMPOSITION_DEPTH) return [semanticIssue(entry2.path, `content groups must be acyclic and nest at most ${MAX_COMPOSITION_DEPTH} levels`)];
+    const ancestors = [...entry2.ancestors, entry2.value];
+    entry2.value.blocks.forEach((block, i) => {
+      stack.push({ value: block, path: `${entry2.path}/blocks/${i}`, depth: entry2.depth + 1, ancestors });
     });
   }
   return [];
 }
 var variableTypeList = VARIABLE_KINDS.join(", ");
-function variableIssue(id, suffix, keyword, message, params) {
+function variableIssue(id, suffix, keyword, message, params2) {
   return {
     instancePath: `/variables/${id.replaceAll("~", "~0").replaceAll("/", "~1")}${suffix}`,
     schemaPath: "#/$defs/Variable/oneOf",
     keyword,
-    params,
+    params: params2,
     message
   };
 }
@@ -984,23 +984,23 @@ function typedVariableErrors(errors, value) {
   const variables = value.variables;
   const kept = errors.filter((error) => !error.instancePath.startsWith("/variables/"));
   const schemaId = schemas.presentation.$id;
-  for (const [id, entry] of Object.entries(variables)) {
-    if (typeof entry === "string") {
-      if (!hexColorPattern.test(entry)) kept.push(variableIssue(id, "", "type", "must be a hex color string or a variable object", {}));
+  for (const [id, entry2] of Object.entries(variables)) {
+    if (typeof entry2 === "string") {
+      if (!hexColorPattern.test(entry2)) kept.push(variableIssue(id, "", "type", "must be a hex color string or a variable object", {}));
       continue;
     }
-    if (!isRecord(entry)) {
+    if (!isRecord(entry2)) {
       kept.push(variableIssue(id, "", "type", "must be a hex color string or a variable object", {}));
       continue;
     }
-    const kind = entry.type;
+    const kind = entry2.type;
     if (typeof kind !== "string" || !VARIABLE_KINDS.includes(kind)) {
       kept.push(variableIssue(id, "/type", "enum", `must be one of: ${variableTypeList} (a hex string is shorthand for a color variable)`, { allowedValues: [...VARIABLE_KINDS] }));
       continue;
     }
     const definition = `${kind.charAt(0).toUpperCase()}${kind.slice(1)}Variable`;
     const check = getAjv().getSchema(`${schemaId}#/$defs/${definition}`);
-    if (!check || check(entry) === true) continue;
+    if (!check || check(entry2) === true) continue;
     for (const error of check.errors ?? []) {
       kept.push({ ...error, instancePath: `/variables/${id.replaceAll("~", "~0").replaceAll("/", "~1")}${error.instancePath}`, schemaPath: `#/$defs/${definition}${error.schemaPath.replace(/^#/, "")}` });
     }
@@ -1044,7 +1044,7 @@ function dataUnionErrors(errors, value) {
     return { ...error, message: field === "fields" ? "'fields' applies only to a dataset-backed table; add 'dataset' or remove 'fields'" : datasetTableMessage(field) };
   });
 }
-function validateAgainstSchema(value, schemaOrKind = "presentation", options = {}) {
+function validateAgainstSchema(value, schemaOrKind = "presentation", options2 = {}) {
   const resolved = resolveValidator(schemaOrKind);
   if (resolved.schemaName === "presentation") {
     const errors2 = contentDepthIssues(value);
@@ -1055,15 +1055,15 @@ function validateAgainstSchema(value, schemaOrKind = "presentation", options = {
   let subject = value;
   let template;
   let unfilledVariables;
-  if (resolved.schemaName === "presentation" && isRecord(value) && (hasContentVariables(value) || options.values !== void 0 || options.template !== void 0)) {
-    template = options.template ?? isTemplate(value);
-    const view = instantiateForValidation(value, options.values ?? {}, template);
+  if (resolved.schemaName === "presentation" && isRecord(value) && (hasContentVariables(value) || options2.values !== void 0 || options2.template !== void 0)) {
+    template = options2.template ?? isTemplate(value);
+    const view = instantiateForValidation(value, options2.values ?? {}, template);
     subject = view.presentation;
     unfilledVariables = view.unfilled;
-    for (const entry of view.diagnostics) {
-      if (entry.code === "variable-example-used" || entry.code === "variable-rich-flattened" || entry.code === "variable-unfilled") continue;
-      const issue2 = semanticIssue(entry.path, entry.message, { id: entry.id, code: entry.code });
-      (entry.severity === "error" ? variableIssues.errors : variableIssues.warnings).push(issue2);
+    for (const entry2 of view.diagnostics) {
+      if (entry2.code === "variable-example-used" || entry2.code === "variable-rich-flattened" || entry2.code === "variable-unfilled") continue;
+      const issue2 = semanticIssue(entry2.path, entry2.message, { id: entry2.id, code: entry2.code });
+      (entry2.severity === "error" ? variableIssues.errors : variableIssues.warnings).push(issue2);
     }
     if (!template) {
       const declared = isRecord(value.variables) ? value.variables : {};
@@ -1085,7 +1085,7 @@ function validateAgainstSchema(value, schemaOrKind = "presentation", options = {
     errors.push(...variableIssues.errors);
     const data = dataIssues(subject);
     errors.push(...data.errors);
-    warnings.push(...presentationReferenceWarnings(subject, options.catalogs));
+    warnings.push(...presentationReferenceWarnings(subject, options2.catalogs));
     warnings.push(...data.warnings);
     warnings.push(...variableIssues.warnings);
   } else if (resolved.schemaName === "language") {
@@ -1104,9 +1104,9 @@ function validateAgainstSchema(value, schemaOrKind = "presentation", options = {
 
 // src/narrative-plan.ts
 var isRec = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-function resolveNarrative(document, options = {}) {
+function resolveNarrative(document, options2 = {}) {
   if (!isRec(document) || typeof document.narrative !== "string") return void 0;
-  const found = resolveReference(document, "narratives", document.narrative, { catalogs: options.catalogs ?? [] });
+  const found = resolveReference(document, "narratives", document.narrative, { catalogs: options2.catalogs ?? [] });
   if (!found) return void 0;
   const record = found.record;
   const beats = Array.isArray(record.beats) ? record.beats.flatMap((beat) => isRec(beat) && typeof beat.id === "string" ? [beat.id] : []) : [];
@@ -1230,7 +1230,7 @@ function simulateVision(hex, model) {
 }
 var PAGE = "#FFFFFF";
 var colorFrom = (scheme, slot, fallback) => typeof slot === "string" ? slot.startsWith("#") ? normalizeHexColor(slot) ?? fallback : normalizeHexColor(scheme[slot]) ?? fallback : fallback;
-function backdropOf(definition, scheme, text, variables, canvasColor) {
+function backdropOf(definition, scheme, text2, variables, canvasColor) {
   const resolve2 = (value, fallback) => backgroundColorRef(value, scheme, variables, fallback);
   const canvas = canvasColor ?? defaultSlideBackground(scheme);
   if (!definition) return { kind: "solid", color: canvas };
@@ -1259,7 +1259,7 @@ function backdropOf(definition, scheme, text, variables, canvasColor) {
         kind: "pattern",
         colors: [
           blend(resolve2(pattern.backgroundColor, PAGE), PAGE, opacity),
-          blend(resolve2(pattern.foregroundColor, text), PAGE, opacity)
+          blend(resolve2(pattern.foregroundColor, text2), PAGE, opacity)
         ]
       };
     }
@@ -1329,24 +1329,24 @@ function colorChoice(levels, scheme, variables = {}) {
 }
 function resolveDesign(document, index, context) {
   const deck = rec(document.design), own4 = rec(rec(rec(document.slides)[index]).design);
-  const { options, diagnostics, resolved } = context;
+  const { options: options2, diagnostics, resolved } = context;
   const { theme, colorScheme, fontScheme, fontSchemePath } = resolved;
   const fontPath = `/${fontSchemePath.split(".").join("/")}`;
   const fontDiagnostic = diagnostics.find((diagnostic) => diagnostic.kind === "fontSchemes");
-  const dimensions = { width: options.width, height: options.height };
+  const dimensions = { width: options2.width, height: options2.height };
   const variables = rec(document.variables);
   const choice = colorChoice([own4, deck, theme], colorScheme, variables);
   const roles = resolveColorRoles(colorScheme, { background: choice.background, variant: choice.variant });
   const dark = roles.dark;
-  const text = roles.text;
-  const backdrop = backdropOf(choice.drawn ? choice.drawn.definition : own4.background ?? deck.background ?? theme.background, colorScheme, text, variables, roles.map.bg1 === "light1" ? void 0 : roles.background);
+  const text2 = roles.text;
+  const backdrop = backdropOf(choice.drawn ? choice.drawn.definition : own4.background ?? deck.background ?? theme.background, colorScheme, text2, variables, roles.map.bg1 === "light1" ? void 0 : roles.background);
   const picture = imageBackground(choice.drawn ? choice.drawn.definition : own4.background ?? deck.background ?? theme.background);
   const backgroundImage = picture && own4.background !== void 0 ? { source: picture.src, fit: picture.fit, path: `/slides/${index}/design/background` } : picture && deck.background !== void 0 ? { source: picture.src, fit: picture.fit, path: "/design/background" } : void 0;
   return {
     theme,
     colorScheme,
     fontScheme,
-    fonts: options.fontFamilies,
+    fonts: options2.fontFamilies,
     dimensions,
     backdrop,
     dark,
@@ -1357,7 +1357,7 @@ function resolveDesign(document, index, context) {
     colors: {
       background: roles.background,
       surface: roles.surface,
-      text,
+      text: text2,
       mutedText: roles.textSecondary,
       primary: roles.primary,
       secondary: roles.secondary,
@@ -1424,10 +1424,10 @@ function backdropColors(backdrop, box, size, layer) {
     }
   }
 }
-function worstContrast(text, sample) {
+function worstContrast(text2, sample) {
   let worst = { ratio: Infinity, against: sample.colors[0] ?? PAGE };
   for (const color of sample.colors) {
-    const ratio = contrastRatio(text, color);
+    const ratio = contrastRatio(text2, color);
     if (ratio < worst.ratio) worst = { ratio, against: color };
   }
   return worst;
@@ -1459,11 +1459,11 @@ function textValues(slide, slidePath) {
     push(at2("text"), node.text, "body", "text");
     for (const field of ["items", "bullets"])
       if (Array.isArray(node[field]))
-        node[field].forEach((entry, index) => {
-          if (isText(entry)) push(at2(field, index), entry, "list", field);
-          else if (entry && typeof entry === "object") {
-            push(at2(field, index, "text"), entry.text, "list", field);
-            push(at2(field, index, "description"), entry.description, "list-description", field);
+        node[field].forEach((entry2, index) => {
+          if (isText(entry2)) push(at2(field, index), entry2, "list", field);
+          else if (entry2 && typeof entry2 === "object") {
+            push(at2(field, index, "text"), entry2.text, "list", field);
+            push(at2(field, index, "description"), entry2.description, "list-description", field);
           }
         });
     const table = rec(node.table);
@@ -1529,9 +1529,9 @@ function altOf(value, assets) {
   if (typeof own4 === "string") return own4;
   let source = typeof value === "string" ? value : rec(value).src;
   for (let hop = 0; typeof source === "string" && source.startsWith("asset:") && hop < 8; hop++) {
-    const entry = rec(assets)[source.slice(6)];
-    if (typeof rec(entry).alt === "string") return rec(entry).alt;
-    source = typeof entry === "string" ? entry : rec(entry).src;
+    const entry2 = rec(assets)[source.slice(6)];
+    if (typeof rec(entry2).alt === "string") return rec(entry2).alt;
+    source = typeof entry2 === "string" ? entry2 : rec(entry2).src;
   }
   return void 0;
 }
@@ -1568,10 +1568,10 @@ function assetRefs(document, slide, slidePath, includeDeck) {
         return;
       }
       for (const shape of LOGO_SHAPES) {
-        const entry = rec(logo)[shape];
-        if (entry === void 0) continue;
-        if (typeof entry === "string" || entry && typeof entry === "object" && "src" in entry) out.push({ path: `${base}/${shape}`, value: entry, kind: "organization" });
-        else for (const tone of ["onLight", "onDark"]) if (rec(entry)[tone] !== void 0) out.push({ path: `${base}/${shape}/${tone}`, value: rec(entry)[tone], kind: "organization" });
+        const entry2 = rec(logo)[shape];
+        if (entry2 === void 0) continue;
+        if (typeof entry2 === "string" || entry2 && typeof entry2 === "object" && "src" in entry2) out.push({ path: `${base}/${shape}`, value: entry2, kind: "organization" });
+        else for (const tone of ["onLight", "onDark"]) if (rec(entry2)[tone] !== void 0) out.push({ path: `${base}/${shape}/${tone}`, value: rec(entry2)[tone], kind: "organization" });
       }
     });
     const speakers = Array.isArray(document.speaker) ? document.speaker : document.speaker ? [document.speaker] : [];
@@ -1603,7 +1603,7 @@ function inkBox(item, measurement) {
   if (!fit || !Array.isArray(fit.lines) || !fit.lines.length || !item.textStyle || item.quoteLayout || item.metricLayout || item.timelineLayout) return item.box;
   try {
     const measure = textWidthMeasurer(item.textStyle, measurement);
-    const width = Math.min(item.box.width, Math.max(...fit.lines.map((line) => measure(line, fit.fontSize))));
+    const width = Math.min(item.box.width, Math.max(...fit.lines.map((line2) => measure(line2, fit.fontSize))));
     const height = Math.min(item.box.height, fit.lines.length * fit.lineHeight);
     const x = item.alignment === "center" ? item.box.x + (item.box.width - width) / 2 : item.alignment === "right" ? item.box.x + item.box.width - width : item.box.x;
     return { x, y: item.box.y, width, height };
@@ -1971,12 +1971,12 @@ var readingOrderRules = [
 function bindingOrder(items, regions) {
   const rank = new Map(regions.map((region, index) => [region.name, index]));
   const blockRank = (item) => {
-    const region = regions.find((entry) => entry.name === item.region);
+    const region = regions.find((entry2) => entry2.name === item.region);
     const blocks = region ? [...region.content, ...region.overflow ?? []] : [];
     const found = blocks.findIndex((block) => item.path === block || item.path.startsWith(`${block}.`));
     return found < 0 ? blocks.length : found;
   };
-  return items.map((item, index) => ({ item, index, region: rank.get(item.region ?? "") ?? regions.length, block: blockRank(item) })).sort((a, b) => a.region - b.region || a.block - b.block || a.index - b.index).map((entry) => entry.item.path);
+  return items.map((item, index) => ({ item, index, region: rank.get(item.region ?? "") ?? regions.length, block: blockRank(item) })).sort((a, b) => a.region - b.region || a.block - b.block || a.index - b.index).map((entry2) => entry2.item.path);
 }
 function visualOrder(items, rtl) {
   if (rtl) return readingRows(items).flatMap((row) => row.map((item) => item.path));
@@ -2005,17 +2005,17 @@ var linkRules = [
             const run = runs[i];
             const link = run.style.link;
             if (typeof link !== "string") continue;
-            let text = run.text;
+            let text2 = run.text;
             let last = i;
-            while (runs[last + 1] && runs[last + 1].style.link === link) text += runs[++last].text;
-            const normalized = text.toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, "").replace(/\s+/g, " ").trim();
-            const problem = !text.trim() ? "is blank" : GENERIC_LINKS.has(normalized) ? "is generic" : /^(https?:\/\/|www\.)\S{30,}$/i.test(text.trim()) ? "is a long raw URL" : void 0;
+            while (runs[last + 1] && runs[last + 1].style.link === link) text2 += runs[++last].text;
+            const normalized = text2.toLowerCase().replace(/[^\p{L}\p{N}\s]/gu, "").replace(/\s+/g, " ").trim();
+            const problem = !text2.trim() ? "is blank" : GENERIC_LINKS.has(normalized) ? "is generic" : /^(https?:\/\/|www\.)\S{30,}$/i.test(text2.trim()) ? "is a long raw URL" : void 0;
             i = last;
             if (!problem) continue;
             context.report(linkRule, {
               path: run.path,
               slide,
-              message: `Link text ${JSON.stringify(text.trim().slice(0, 50))} ${problem}; the destination is ${link.length > 60 ? `${link.slice(0, 57)}...` : link}.`,
+              message: `Link text ${JSON.stringify(text2.trim().slice(0, 50))} ${problem}; the destination is ${link.length > 60 ? `${link.slice(0, 57)}...` : link}.`,
               help: 'Use text that names the destination or action, for example "Q3 financial results (PDF)", instead of "click here".',
               fixes: [{ id: "focus-link", title: "Edit the text", kind: "focus", safe: true, focus: { path: run.valuePath, field: "link", value: link } }]
             });
@@ -2116,12 +2116,12 @@ var chartRules = [
           const resolved = resolveChartColors(chart.colors, slide.design.colorScheme, chartColorContext(slide.design));
           resolved.forEach((color, index) => {
             const path = `${payload.path === slide.path ? slide.path : payload.path}/chart/colors/${index}`;
-            const entry = chart.colors[index];
+            const entry2 = chart.colors[index];
             if (color === void 0) {
               context.report(chartColorsRule, {
                 path,
                 slide,
-                message: `Chart colour ${index + 1} (${JSON.stringify(entry)}) cannot be resolved, so the palette colour of that position is used.`,
+                message: `Chart colour ${index + 1} (${JSON.stringify(entry2)}) cannot be resolved, so the palette colour of that position is used.`,
                 help: 'Use a hex colour, a colour-scheme name such as "accent2", or the id of a colour variable the deck defines (var:<id>).'
               });
               return;
@@ -2602,13 +2602,13 @@ var contentRules = [
     run(context) {
       for (const slide of context.slides)
         for (const tv of slide.texts) {
-          const text = plainText(tv.value);
-          const hit = PLACEHOLDERS.find(({ pattern }) => pattern.test(text));
+          const text2 = plainText(tv.value);
+          const hit = PLACEHOLDERS.find(({ pattern }) => pattern.test(text2));
           if (!hit) continue;
           context.report(placeholderRule, {
             path: tv.path,
             slide,
-            message: `Text looks like ${hit.label}: ${JSON.stringify(text.length > 60 ? `${text.slice(0, 57)}...` : text)}.`,
+            message: `Text looks like ${hit.label}: ${JSON.stringify(text2.length > 60 ? `${text2.slice(0, 57)}...` : text2)}.`,
             help: "Replace it with the real content, or delete the element.",
             fixes: [{ id: "focus-text", title: "Edit the text", kind: "focus", safe: true, focus: { path: tv.path, field: "text" } }]
           });
@@ -2848,7 +2848,7 @@ var infos = [
   ...referenceRules,
   ...policyRules,
   ...dataRules,
-  ...implementations.flatMap((entry) => [entry.info, ...entry.also ?? []])
+  ...implementations.flatMap((entry2) => [entry2.info, ...entry2.also ?? []])
 ];
 var validationRules = Object.freeze(
   infos.map((info, index) => ({ info, index })).sort((a, b) => validationCategories.indexOf(a.info.category) - validationCategories.indexOf(b.info.category) || a.index - b.index).map(({ info }) => Object.freeze({ ...info }))
@@ -2867,6 +2867,10 @@ function ruleInfo(id) {
   if (!found) throw new Error(`Validation rule ${JSON.stringify(id)} is not registered.`);
   return found;
 }
+var VALIDATE_DOCS = "https://github.com/OpenPresentation/opf/blob/main/docs/validate.md";
+function ruleDocumentation(id) {
+  return `${VALIDATE_DOCS}#${id.replace("/", "")}`;
+}
 
 // src/check-document.ts
 var own = (value, key2) => Object.hasOwn(value, key2);
@@ -2885,12 +2889,12 @@ function at(value, path) {
     value
   );
 }
-function checkDocumentOptions(options) {
-  checkCatalogsOption(options.catalogs, "validate");
-  if (options.contracts !== void 0 && !Array.isArray(options.contracts))
+function checkDocumentOptions(options2) {
+  checkCatalogsOption(options2.catalogs, "validate");
+  if (options2.contracts !== void 0 && !Array.isArray(options2.contracts))
     throw new TypeError("Validate contracts must be an array.");
-  for (const contract of options.contracts ?? []) {
-    if (!object(contract) || Object.keys(contract).some(
+  for (const contract2 of options2.contracts ?? []) {
+    if (!object(contract2) || Object.keys(contract2).some(
       (key2) => ![
         "path",
         "allowedValues",
@@ -2898,11 +2902,11 @@ function checkDocumentOptions(options) {
         "message",
         "documentation"
       ].includes(key2)
-    ) || typeof contract.path !== "string" || !Array.isArray(contract.allowedValues) || !contract.allowedValues.every(primitive) || contract.severity !== void 0 && (typeof contract.severity !== "string" || !["error", "warning", "info"].includes(contract.severity)) || contract.message !== void 0 && typeof contract.message !== "string" || contract.documentation !== void 0 && typeof contract.documentation !== "string")
+    ) || typeof contract2.path !== "string" || !Array.isArray(contract2.allowedValues) || !contract2.allowedValues.every(primitive) || contract2.severity !== void 0 && (typeof contract2.severity !== "string" || !["error", "warning", "info"].includes(contract2.severity)) || contract2.message !== void 0 && typeof contract2.message !== "string" || contract2.documentation !== void 0 && typeof contract2.documentation !== "string")
       throw new TypeError(
         "Invalid contract: provide a path and primitive allowedValues, with optional severity, message and documentation."
       );
-    parts(contract.path);
+    parts(contract2.path);
   }
 }
 function finding(ruleId, data) {
@@ -2912,10 +2916,10 @@ function finding(ruleId, data) {
 }
 var issueRuleId = (issue2) => typeof issue2.params.code === "string" && issue2.keyword === "opf" ? `opf/${issue2.params.code}` : "opf/schema";
 function issueFinding(issue2, ruleId = issueRuleId(issue2), schemaName = "presentation", prefix = "", scope = "document", severity) {
-  const path = prefix + (issue2.path === "/" ? "" : issue2.path) + (issue2.keyword === "additionalProperties" && typeof issue2.params.additionalProperty === "string" ? pointer3([issue2.params.additionalProperty]) : ""), entry = schemaEntries.find((entry2) => entry2.name === schemaName);
-  if (!entry) throw new TypeError(`Unknown schema ${schemaName}`);
+  const path = prefix + (issue2.path === "/" ? "" : issue2.path) + (issue2.keyword === "additionalProperties" && typeof issue2.params.additionalProperty === "string" ? pointer3([issue2.params.additionalProperty]) : ""), entry2 = schemaEntries.find((entry3) => entry3.name === schemaName);
+  if (!entry2) throw new TypeError(`Unknown schema ${schemaName}`);
   const precise = validationDefinition(issue2);
-  const definition = precise?.uri ?? (issue2.keyword === "opf" ? "packages/javascript/src/schema-check.ts" : issue2.schemaPath.startsWith("#") ? entry.schema.$id + issue2.schemaPath : issue2.schemaPath);
+  const definition = precise?.uri ?? (issue2.keyword === "opf" ? "packages/javascript/src/schema-check.ts" : issue2.schemaPath.startsWith("#") ? entry2.schema.$id + issue2.schemaPath : issue2.schemaPath);
   const lookup = [
     "opf",
     "schema",
@@ -2932,7 +2936,7 @@ function issueFinding(issue2, ruleId = issueRuleId(issue2), schemaName = "presen
   else if (issue2.keyword === "opf")
     help = "Resolve the reported structural conflict while preserving every content field. Preview the result after editing.";
   const allowed = Array.isArray(issue2.params.allowedValues) ? issue2.params.allowedValues.filter(primitive) : [];
-  const nearest = issue2.keyword === "additionalProperties" ? nearestProperties(issue2, entry.schema, precise?.pointer, precise?.schemaName) : [];
+  const nearest2 = issue2.keyword === "additionalProperties" ? nearestProperties(issue2, entry2.schema, precise?.pointer, precise?.schemaName) : [];
   return finding(ruleId, {
     ...severity ? { severity } : {},
     path,
@@ -2949,14 +2953,14 @@ function issueFinding(issue2, ruleId = issueRuleId(issue2), schemaName = "presen
         origin: "schema",
         definition
       }))
-    } : nearest.length ? { suggestions: nearest } : {}
+    } : nearest2.length ? { suggestions: nearest2 } : {}
   });
 }
 var NEAREST_PROPERTIES = 3;
 function nearestProperties(issue2, fallbackRoot, pointerToKeyword, schemaName) {
   const typed = issue2.params.additionalProperty;
   if (typeof typed !== "string" || pointerToKeyword === void 0) return [];
-  const rootEntry = schemaEntries.find((entry) => entry.name === schemaName);
+  const rootEntry = schemaEntries.find((entry2) => entry2.name === schemaName);
   let node = rootEntry?.schema ?? fallbackRoot;
   const base = pointerToKeyword.split("/").slice(0, -1);
   for (const token of base.slice(1)) {
@@ -2978,7 +2982,7 @@ function resolve(cursor, seen = /* @__PURE__ */ new Set()) {
   const id = String(cursor.root.$id ?? "") + ref;
   if (seen.has(id)) return { ...cursor, schema: {} };
   seen.add(id);
-  const [base, fragment = ""] = ref.split("#"), root = base ? schemaEntries.find((entry) => entry.schema.$id === base)?.schema : cursor.root;
+  const [base, fragment = ""] = ref.split("#"), root = base ? schemaEntries.find((entry2) => entry2.schema.$id === base)?.schema : cursor.root;
   if (!root) return { ...cursor, schema: {} };
   const target = at(root, fragment);
   if (!object(target)) return { ...cursor, schema: {} };
@@ -3061,29 +3065,29 @@ function fields(document) {
     }
   ];
   while (stack.length) {
-    const entry = stack.pop();
-    if (!entry) break;
-    if (entry.ancestors.includes(entry.value)) continue;
-    const resolved = resolve(entry.cursor), selected = active(entry.cursor, entry.value);
-    const assetReference = [resolved, selected].some(
+    const entry2 = stack.pop();
+    if (!entry2) break;
+    if (entry2.ancestors.includes(entry2.value)) continue;
+    const resolved = resolve(entry2.cursor), selected = active(entry2.cursor, entry2.value);
+    const assetReference2 = [resolved, selected].some(
       (cursor) => cursor.root.$id === schemas.presentation.$id && (cursor.path === "/$defs/Asset" || cursor.path === "/$defs/Asset/oneOf/0" || cursor.path === "/$defs/Watermark/properties/src") || String(cursor.schema.description ?? "").includes("asset:") || Array.isArray(cursor.schema.examples) && cursor.schema.examples.some(
         (example) => typeof example === "string" && example.startsWith("asset:")
       )
     );
     result.push({
-      path: pointer3(entry.path),
-      value: entry.value,
+      path: pointer3(entry2.path),
+      value: entry2.value,
       cursor: resolved,
-      assetReference
+      assetReference: assetReference2
     });
-    const ancestors = [...entry.ancestors, entry.value];
+    const ancestors = [...entry2.ancestors, entry2.value];
     const cursors = [selected, ...selected.baseSchemas ?? [], resolved];
     const arrayCursor = cursors.find((cursor) => object(cursor.schema.items));
-    if (Array.isArray(entry.value) && arrayCursor)
-      entry.value.forEach((value, index) => {
+    if (Array.isArray(entry2.value) && arrayCursor)
+      entry2.value.forEach((value, index) => {
         stack.push({
           value,
-          path: [...entry.path, index],
+          path: [...entry2.path, index],
           cursor: {
             schema: arrayCursor.schema.items,
             root: arrayCursor.root,
@@ -3092,14 +3096,14 @@ function fields(document) {
           ancestors
         });
       });
-    else if (object(entry.value))
-      for (const [key2, value] of Object.entries(entry.value)) {
-        if (entry.path.length === 0 && key2 === "catalogs") continue;
+    else if (object(entry2.value))
+      for (const [key2, value] of Object.entries(entry2.value)) {
+        if (entry2.path.length === 0 && key2 === "catalogs") continue;
         const cursor = childCursor(cursors, key2);
         if (!cursor) continue;
         stack.push({
           value,
-          path: [...entry.path, key2],
+          path: [...entry2.path, key2],
           cursor,
           ancestors
         });
@@ -3113,7 +3117,7 @@ function recordIssues(kind, id, value) {
   const schemaName = catalogSchemaNames[kind];
   return validateAgainstSchema(object(value) ? { $schema: schemas[schemaName].$id, id, ...value } : value, kind);
 }
-function embeddedRecordFindings(document, options, findings) {
+function embeddedRecordFindings(document, options2, findings) {
   const invalid = /* @__PURE__ */ new Set();
   if (!object(document) || !object(document.catalogs)) return invalid;
   for (const [group, value] of Object.entries(document.catalogs)) {
@@ -3126,8 +3130,8 @@ function embeddedRecordFindings(document, options, findings) {
         for (const issue2 of validation.errors) findings.push(issueFinding(issue2, recordRuleId(issue2), catalogSchemaNames[kind], path, "document"));
         if (!validation.valid) invalid.add(recordKey(group, kind, id));
         if (group === "custom") continue;
-        const source = catalogGroupSource(document, group, options);
-        const registered = registeredCatalog(source, options);
+        const source = catalogGroupSource(document, group, options2);
+        const registered = registeredCatalog(source, options2);
         if (!registered || Object.hasOwn(registered[kind] ?? {}, id)) continue;
         findings.push(
           finding("opf/catalog-record-not-in-source", {
@@ -3198,11 +3202,11 @@ function engineFindings(document, engine, enabled) {
   }
   let numberFixes;
   for (const issue2 of engine.warnings) {
-    const code = issue2.params.code;
-    if (typeof code !== "string") continue;
-    const ruleId = `opf/${code}`;
+    const code2 = issue2.params.code;
+    if (typeof code2 !== "string") continue;
+    const ruleId = `opf/${code2}`;
     if (!enabled(ruleId)) continue;
-    if (code === "chart-value-not-numeric") {
+    if (code2 === "chart-value-not-numeric") {
       numberFixes ??= chartNumberFixPaths(document);
       const fix = numberFixes.get(issue2.path);
       if (fix) {
@@ -3215,7 +3219,7 @@ function engineFindings(document, engine, enabled) {
       }
     }
     const found = issueFinding(issue2, ruleId, "presentation", "", "document", "warning");
-    const help = HELP[code];
+    const help = HELP[code2];
     if (help) found.help = help;
     findings.push(found);
   }
@@ -3249,12 +3253,12 @@ function variableFindings(document, engine, schemaValid) {
     if (depth2 > 64) return;
     if (typeof value === "string") {
       if (value.startsWith("data:") || !value.includes("{{")) return;
-      for (const match of value.matchAll(VARIABLE_TOKEN))
-        if (match[1])
+      for (const match2 of value.matchAll(VARIABLE_TOKEN))
+        if (match2[1])
           findings.push(
             finding("opf/variable-unfilled", {
               path: pointer3(path),
-              message: `Template variable ${JSON.stringify(match[0])} is still in the text.`,
+              message: `Template variable ${JSON.stringify(match2[0])} is still in the text.`,
               help: "Declare the variable and fill it, or replace the token with the real value.",
               severity: "warning"
             })
@@ -3262,15 +3266,15 @@ function variableFindings(document, engine, schemaValid) {
       return;
     }
     if (Array.isArray(value)) {
-      value.forEach((entry, index) => {
-        walk2(entry, [...path, String(index)], depth2 + 1);
+      value.forEach((entry2, index) => {
+        walk2(entry2, [...path, String(index)], depth2 + 1);
       });
       return;
     }
     if (value && typeof value === "object")
-      for (const [key2, entry] of Object.entries(value)) {
+      for (const [key2, entry2] of Object.entries(value)) {
         if (path.length === 0 && ["variables", "extensions", "catalogs", "assets"].includes(key2)) continue;
-        walk2(entry, [...path, key2], depth2 + 1);
+        walk2(entry2, [...path, key2], depth2 + 1);
       }
   };
   walk2(document, [], 0);
@@ -3297,22 +3301,22 @@ function undeclaredCatalogFindings(document) {
   }
   return findings;
 }
-function contentReferenceFindings(document, options, findings) {
-  const invalid = embeddedRecordFindings(document, options, findings);
+function contentReferenceFindings(document, options2, findings) {
+  const invalid = embeddedRecordFindings(document, options2, findings);
   const registeredChecked = /* @__PURE__ */ new Set();
   for (const site of catalogReferenceSites(document)) {
     const path = pointerPath(site.path);
     const parsed = parseReference(site.reference);
     if (parsed?.group !== void 0 && !catalogGroupDeclared(document, parsed.group)) continue;
-    const found = resolveReference(document, site.kind, site.reference, { ...options, ...site.group !== void 0 ? { group: site.group } : {} });
+    const found = resolveReference(document, site.kind, site.reference, { ...options2, ...site.group !== void 0 ? { group: site.group } : {} });
     if (found?.origin === "host" && !registeredChecked.has(recordKey(found.group, site.kind, found.id))) {
       registeredChecked.add(recordKey(found.group, site.kind, found.id));
       for (const issue2 of recordIssues(site.kind, found.id, found.record).errors)
         findings.push(issueFinding(issue2, recordRuleId(issue2), catalogSchemaNames[site.kind], pointer3(["catalogs", found.group, site.kind, found.id]), "context"));
     }
     if (found && !(found.origin === "document" && invalid.has(recordKey(found.group, site.kind, found.id)))) continue;
-    const diagnostic = unresolvedReference(document, site.kind, site.reference, path, options);
-    const suggestions = catalogRecords(document, site.kind, options).map((entry) => ({ value: entry.reference, label: typeof entry.record.name === "string" ? entry.record.name : entry.reference, origin: entry.origin === "host" ? "registered" : "document", definition: entry.origin === "document" ? `document#${pointer3(["catalogs", entry.group, site.kind, entry.id])}` : `${entry.source ?? "context"}#/${site.kind}/${entry.id}` })).sort((a, b) => distance(site.reference, a.value) - distance(site.reference, b.value) || (a.value < b.value ? -1 : a.value > b.value ? 1 : 0)).slice(0, 5);
+    const diagnostic = unresolvedReference(document, site.kind, site.reference, path, options2);
+    const suggestions = catalogRecords(document, site.kind, options2).map((entry2) => ({ value: entry2.reference, label: typeof entry2.record.name === "string" ? entry2.record.name : entry2.reference, origin: entry2.origin === "host" ? "registered" : "document", definition: entry2.origin === "document" ? `document#${pointer3(["catalogs", entry2.group, site.kind, entry2.id])}` : `${entry2.source ?? "context"}#/${site.kind}/${entry2.id}` })).sort((a, b) => distance(site.reference, a.value) - distance(site.reference, b.value) || (a.value < b.value ? -1 : a.value > b.value ? 1 : 0)).slice(0, 5);
     findings.push(
       finding("opf/unresolved-reference", {
         path,
@@ -3325,9 +3329,9 @@ function contentReferenceFindings(document, options, findings) {
     );
   }
 }
-function referenceFindings(document, engine, options) {
+function referenceFindings(document, engine, options2) {
   const findings = [];
-  const catalogs = { catalogs: options.catalogs ?? [] };
+  const catalogs = { catalogs: options2.catalogs ?? [] };
   contentReferenceFindings(document, catalogs, findings);
   const assetValues = object(document) && object(document.assets) ? document.assets : {};
   for (const field of fields(document)) {
@@ -3402,10 +3406,10 @@ function referenceFindings(document, engine, options) {
     );
   return findings;
 }
-function narrativeFindings(document, options) {
+function narrativeFindings(document, options2) {
   const findings = [];
   if (!object(document)) return findings;
-  const narrative = resolveNarrative(document, options);
+  const narrative = resolveNarrative(document, options2);
   if (narrative) {
     const id = String(document.narrative);
     const beatSuggestions = (beat) => narrative.beats.slice().sort((a, b) => distance(beat, a) - distance(beat, b) || (a < b ? -1 : a > b ? 1 : 0)).slice(0, 5).map((value) => ({ value, label: value, origin: narrative.origin, definition: `narratives/${id}#/beats` }));
@@ -3449,32 +3453,32 @@ function narrativeFindings(document, options) {
 }
 function contractFindings(document, contracts) {
   const findings = [];
-  for (const [index, contract] of contracts.entries()) {
-    const pattern = parts(contract.path), stack = [{ value: document, path: [], depth: 0 }];
+  for (const [index, contract2] of contracts.entries()) {
+    const pattern = parts(contract2.path), stack = [{ value: document, path: [], depth: 0 }];
     while (stack.length) {
-      const entry = stack.pop();
-      if (!entry) break;
-      if (entry.depth === pattern.length) {
-        if (contract.allowedValues.some((value) => Object.is(value, entry.value)))
+      const entry2 = stack.pop();
+      if (!entry2) break;
+      if (entry2.depth === pattern.length) {
+        if (contract2.allowedValues.some((value) => Object.is(value, entry2.value)))
           continue;
-        const path = pointer3(entry.path), definition = contract.documentation ?? `context#/contracts/${index}`, values = {
+        const path = pointer3(entry2.path), definition = contract2.documentation ?? `context#/contracts/${index}`, values = {
           path,
-          value: JSON.stringify(entry.value),
-          allowed: contract.allowedValues.map((value) => JSON.stringify(value)).join(", "),
+          value: JSON.stringify(entry2.value),
+          allowed: contract2.allowedValues.map((value) => JSON.stringify(value)).join(", "),
           file: definition
         };
-        const message = (contract.message ?? "This value is outside the allowed values for {{path}}.").replace(
+        const message = (contract2.message ?? "This value is outside the allowed values for {{path}}.").replace(
           /\{\{(path|value|allowed|file)\}\}/g,
           (_, key2) => values[key2] ?? ""
         );
         findings.push(
           finding("opf/contract", {
-            severity: contract.severity ?? "error",
+            severity: contract2.severity ?? "error",
             path,
             message,
             help: `Use one of the configured values: ${values.allowed}. This is an explicit host policy; no source was changed.`,
             definition,
-            suggestions: contract.allowedValues.map((value) => ({
+            suggestions: contract2.allowedValues.map((value) => ({
               value,
               label: String(value),
               origin: "contract",
@@ -3482,14 +3486,14 @@ function contractFindings(document, contracts) {
             }))
           })
         );
-      } else if (object(entry.value) || Array.isArray(entry.value)) {
-        const key2 = pattern[entry.depth];
-        for (const [name, value] of Object.entries(entry.value))
+      } else if (object(entry2.value) || Array.isArray(entry2.value)) {
+        const key2 = pattern[entry2.depth];
+        for (const [name, value] of Object.entries(entry2.value))
           if (key2 === "*" || key2 === name)
             stack.push({
               value,
-              path: [...entry.path, name],
-              depth: entry.depth + 1
+              path: [...entry2.path, name],
+              depth: entry2.depth + 1
             });
       }
     }
@@ -3506,10 +3510,10 @@ var OPFPatchError = class extends Error {
   index;
   /** The failing operation, when known. */
   operation;
-  constructor(code, message, details = {}) {
+  constructor(code2, message, details = {}) {
     super(message);
     this.name = "OPFPatchError";
-    this.code = code;
+    this.code = code2;
     if (details.path !== void 0) this.path = details.path;
     if (details.index !== void 0) this.index = details.index;
     if (details.operation !== void 0) this.operation = details.operation;
@@ -3598,12 +3602,12 @@ function arrayIndex(token, length, allowEnd, path) {
   if (!Number.isSafeInteger(at2) || at2 > length || !allowEnd && at2 >= length) throw new OPFPatchError("invalid-array-index", `Array index out of bounds: ${token}`, { path });
   return at2;
 }
-function normalizePatch(patch) {
-  if (!Array.isArray(patch)) throw new OPFPatchError("invalid-patch", "A JSON Patch must be an array of operations.");
-  return patch.map((operation, index) => normalizeOperation(operation, index));
+function normalizePatch(patch2) {
+  if (!Array.isArray(patch2)) throw new OPFPatchError("invalid-patch", "A JSON Patch must be an array of operations.");
+  return patch2.map((operation, index) => normalizeOperation(operation, index));
 }
 function normalizeOperation(operation, index) {
-  const fail = (code, message, path) => new OPFPatchError(code, index === void 0 ? message : `Operation ${index}: ${message}`, { index, operation, path });
+  const fail = (code2, message, path) => new OPFPatchError(code2, index === void 0 ? message : `Operation ${index}: ${message}`, { index, operation, path });
   if (!isObject(operation)) throw fail("invalid-patch-operation", "Expected an operation object.");
   const op = operation.op;
   if (typeof op !== "string" || !["add", "remove", "replace", "move", "copy", "test"].includes(op)) {
@@ -3722,8 +3726,8 @@ function applyOne(document, operation) {
     }
   }
 }
-function applyPatchWithInverse(document, patch, options = {}) {
-  const operations = normalizePatch(patch);
+function applyPatchWithInverse(document, patch2, options2 = {}) {
+  const operations = normalizePatch(patch2);
   let working = clone(document);
   const inverse = [];
   for (const [index, operation] of operations.entries()) {
@@ -3740,19 +3744,19 @@ function applyPatchWithInverse(document, patch, options = {}) {
     }
   }
   const result = { presentation: working, inverse, patch: operations };
-  if (options.validate) {
-    const validator = typeof options.validate === "function" ? options.validate : (value) => validate(value, { only: options.strict ? ["format", "references"] : ["format"] });
+  if (options2.validate) {
+    const validator = typeof options2.validate === "function" ? options2.validate : (value) => validate(value, { only: options2.strict ? ["format", "references"] : ["format"] });
     const validation = validator(working);
-    if (!validation.valid || options.strict && validation.findings?.some((entry) => entry.severity === "warning")) throw new OPFPatchValidationError(validation);
+    if (!validation.valid || options2.strict && validation.findings?.some((entry2) => entry2.severity === "warning")) throw new OPFPatchValidationError(validation);
     result.validation = validation;
   }
   return result;
 }
-function applyPatch(document, patch, options = {}) {
-  return applyPatchWithInverse(document, patch, options).presentation;
+function applyPatch(document, patch2, options2 = {}) {
+  return applyPatchWithInverse(document, patch2, options2).presentation;
 }
-function invertPatch(document, patch) {
-  return applyPatchWithInverse(document, patch).inverse;
+function invertPatch(document, patch2) {
+  return applyPatchWithInverse(document, patch2).inverse;
 }
 
 // src/schema-catalog-kinds.ts
@@ -4018,7 +4022,7 @@ function variantType(variant) {
   if (Array.isArray(variant.enum) && variant.enum.length) return variant.enum[0] === null ? "null" : typeof variant.enum[0];
   return "any";
 }
-var firstParagraph = (text) => typeof text === "string" && text.trim() ? (text.trim().split(/\n[ \t]*\n/)[0] ?? "").trim() : void 0;
+var firstParagraph = (text2) => typeof text2 === "string" && text2.trim() ? (text2.trim().split(/\n[ \t]*\n/)[0] ?? "").trim() : void 0;
 var definitionOf = (raw) => typeof raw.$ref === "string" ? /#\/\$defs\/([^/]+)$/.exec(raw.$ref)?.[1] : void 0;
 function enumValues(variants, inherited) {
   const seen = /* @__PURE__ */ new Map();
@@ -4204,14 +4208,14 @@ function catalogKindAt(path, document) {
 }
 
 // src/source-text.ts
-function createLocator(text) {
+function createLocator(text2) {
   const lineStarts = [0];
-  for (let index = 0; index < text.length; index++) {
-    const code = text.charCodeAt(index);
-    if (code === 13) {
-      if (text.charCodeAt(index + 1) === 10) index++;
+  for (let index = 0; index < text2.length; index++) {
+    const code2 = text2.charCodeAt(index);
+    if (code2 === 13) {
+      if (text2.charCodeAt(index + 1) === 10) index++;
       lineStarts.push(index + 1);
-    } else if (code === 10) lineStarts.push(index + 1);
+    } else if (code2 === 10) lineStarts.push(index + 1);
   }
   return (offset, length) => {
     let low = 0;
@@ -4224,28 +4228,28 @@ function createLocator(text) {
     return { offset, length, line: low + 1, column: offset - (lineStarts[low] ?? 0) + 1 };
   };
 }
-function applyTextEdits(text, edits) {
+function applyTextEdits(text2, edits) {
   const ordered = edits.map((edit, index) => ({ edit, index })).sort((a, b) => a.edit.offset - b.edit.offset || a.index - b.index);
   let result = "";
   let cursor = 0;
   for (const { edit } of ordered) {
     if (edit.offset < cursor) throw new RangeError("Text edits overlap.");
-    result += text.slice(cursor, edit.offset) + edit.insert;
+    result += text2.slice(cursor, edit.offset) + edit.insert;
     cursor = edit.offset + edit.length;
   }
-  return result + text.slice(cursor);
+  return result + text2.slice(cursor);
 }
 function rememberByText(read, size = 2) {
   const kept = [];
-  return (text) => {
-    const at2 = kept.findIndex((entry) => entry.text === text);
+  return (text2) => {
+    const at2 = kept.findIndex((entry2) => entry2.text === text2);
     if (at2 >= 0) {
-      const [entry] = kept.splice(at2, 1);
-      kept.unshift(entry);
-      return entry.value;
+      const [entry2] = kept.splice(at2, 1);
+      kept.unshift(entry2);
+      return entry2.value;
     }
-    const value = read(text);
-    kept.unshift({ text, value });
+    const value = read(text2);
+    kept.unshift({ text: text2, value });
     if (kept.length > size) kept.pop();
     return value;
   };
@@ -4257,18 +4261,18 @@ var NUMBER = /^-?(?:0|[1-9][0-9]*)(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$/;
 var TYPOGRAPHIC = /[\u2018-\u201F\u00AB\u00BB]/;
 var HEX = /^[0-9a-fA-F]{4}$/;
 var isBreak = (char) => char === "\n" || char === "\r";
-function tokenize(text) {
+function tokenize(text2) {
   const tokens = [];
   const lexical = { escapes: /* @__PURE__ */ new Map(), unicode: /* @__PURE__ */ new Map(), controls: /* @__PURE__ */ new Map() };
-  const length = text.length;
-  let index = text.charCodeAt(0) === 65279 ? 1 : 0;
+  const length = text2.length;
+  let index = text2.charCodeAt(0) === 65279 ? 1 : 0;
   const push = (token) => {
-    const full = { ...token, text: text.slice(token.start, token.end) };
+    const full = { ...token, text: text2.slice(token.start, token.end) };
     tokens.push(full);
     return full;
   };
   while (index < length) {
-    const char = text[index];
+    const char = text2[index];
     if (char === " " || char === "	" || char === "\n" || char === "\r") {
       index++;
       continue;
@@ -4286,7 +4290,7 @@ function tokenize(text) {
       const controls = [];
       let terminated = false;
       while (index < length) {
-        const current = text[index];
+        const current = text2[index];
         if (current === '"') {
           terminated = true;
           index++;
@@ -4294,12 +4298,12 @@ function tokenize(text) {
         }
         if (isBreak(current)) break;
         if (current === "\\") {
-          const following = text[index + 1];
+          const following = text2[index + 1];
           if (following === void 0 || isBreak(following)) {
             escapes.push(index);
             index++;
           } else if (following === "u") {
-            if (HEX.test(text.slice(index + 2, index + 6))) index += 6;
+            if (HEX.test(text2.slice(index + 2, index + 6))) index += 6;
             else {
               unicode.push(index);
               index += 2;
@@ -4324,9 +4328,9 @@ function tokenize(text) {
       index++;
       let terminated = false;
       while (index < length) {
-        const current = text[index];
+        const current = text2[index];
         if (isBreak(current)) break;
-        if (current === "\\" && index + 1 < length && !isBreak(text[index + 1])) {
+        if (current === "\\" && index + 1 < length && !isBreak(text2[index + 1])) {
           index += 2;
           continue;
         }
@@ -4343,7 +4347,7 @@ function tokenize(text) {
       index++;
       let terminated = false;
       while (index < length) {
-        const current = text[index];
+        const current = text2[index];
         if (isBreak(current)) break;
         index++;
         if (current === '"' || TYPOGRAPHIC.test(current)) {
@@ -4354,35 +4358,35 @@ function tokenize(text) {
       push({ kind: "string", start, end: index, quote: "typographic", terminated });
       continue;
     }
-    if (char === "/" && text[index + 1] === "/") {
-      while (index < length && !isBreak(text[index])) index++;
+    if (char === "/" && text2[index + 1] === "/") {
+      while (index < length && !isBreak(text2[index])) index++;
       push({ kind: "comment", start, end: index });
       continue;
     }
-    if (char === "/" && text[index + 1] === "*") {
-      const close = text.indexOf("*/", index + 2);
+    if (char === "/" && text2[index + 1] === "*") {
+      const close = text2.indexOf("*/", index + 2);
       index = close < 0 ? length : close + 2;
       push({ kind: "comment", start, end: index, block: true, terminated: close >= 0 });
       continue;
     }
-    if (WORD.test(String.fromCodePoint(text.codePointAt(index) ?? 0))) {
+    if (WORD.test(String.fromCodePoint(text2.codePointAt(index) ?? 0))) {
       while (index < length) {
-        const code = text.codePointAt(index) ?? 0;
-        if (!WORD.test(String.fromCodePoint(code))) break;
-        index += code > 65535 ? 2 : 1;
+        const code2 = text2.codePointAt(index) ?? 0;
+        if (!WORD.test(String.fromCodePoint(code2))) break;
+        index += code2 > 65535 ? 2 : 1;
       }
-      const lexeme = text.slice(start, index);
+      const lexeme = text2.slice(start, index);
       const kind = NUMBER.test(lexeme) ? "number" : lexeme === "true" || lexeme === "false" || lexeme === "null" ? "literal" : /^[+\-.]?[0-9]|^[+-]$/.test(lexeme) ? "badnumber" : "word";
       push({ kind, start, end: index });
       continue;
     }
     while (index < length) {
-      const code = text.codePointAt(index) ?? 0;
-      const next = String.fromCodePoint(code);
+      const code2 = text2.codePointAt(index) ?? 0;
+      const next = String.fromCodePoint(code2);
       if (/[\s{}[\],:"'/]/.test(next) || TYPOGRAPHIC.test(next) || WORD.test(next)) break;
-      index += code > 65535 ? 2 : 1;
+      index += code2 > 65535 ? 2 : 1;
     }
-    if (index === start) index += (text.codePointAt(index) ?? 0) > 65535 ? 2 : 1;
+    if (index === start) index += (text2.codePointAt(index) ?? 0) > 65535 ? 2 : 1;
     push({ kind: "unknown", start, end: index });
   }
   push({ kind: "eof", start: length, end: length });
@@ -4393,14 +4397,14 @@ function clip(value, max = 40) {
   const collapsed = value.replace(/\s+/g, " ").trim();
   return collapsed.length > max ? `${collapsed.slice(0, max - 1)}\u2026` : collapsed;
 }
-function lineBounds(text, offset) {
+function lineBounds(text2, offset) {
   let start = offset;
-  while (start > 0 && !isBreak(text[start - 1])) start--;
+  while (start > 0 && !isBreak(text2[start - 1])) start--;
   let end = offset;
-  while (end < text.length && !isBreak(text[end])) end++;
+  while (end < text2.length && !isBreak(text2[end])) end++;
   return { start, end };
 }
-var indentOf = (text, offset) => /^[ \t]*/.exec(text.slice(lineBounds(text, offset).start))?.[0] ?? "";
+var indentOf = (text2, offset) => /^[ \t]*/.exec(text2.slice(lineBounds(text2, offset).start))?.[0] ?? "";
 function unquoteSingle(raw) {
   const inner = raw.endsWith("'") && raw.length > 1 ? raw.slice(1, -1) : raw.slice(1);
   let result = "";
@@ -4421,13 +4425,13 @@ var YAML_START = /^[A-Za-z_][\w.-]*\s*:(?:\s|$)/;
 var MINIMAL_DECK = '{\n  "slides": [\n    { "title": "" }\n  ]\n}\n';
 var HINT_FORMS_LIMIT = 2;
 var Analyzer = class {
-  constructor(text) {
-    this.text = text;
-    const lexed = tokenize(text);
+  constructor(text2) {
+    this.text = text2;
+    const lexed = tokenize(text2);
     this.comments = lexed.tokens.filter((token) => token.kind === "comment");
     this.tokens = lexed.tokens.filter((token) => token.kind !== "comment");
     this.lexical = lexed.lexical;
-    this.locate = createLocator(text);
+    this.locate = createLocator(text2);
   }
   text;
   problems = [];
@@ -4622,7 +4626,7 @@ var Analyzer = class {
     return { offset: start, length: end - start, insert: "" };
   }
   stringProblems(token) {
-    const { text } = this;
+    const { text: text2 } = this;
     if (token.quote === "single") {
       this.add({
         code: "single-quotes",
@@ -4649,7 +4653,7 @@ var Analyzer = class {
     const unicode = this.lexical.unicode.get(token);
     const controls = this.lexical.controls.get(token);
     if (token.terminated === false) {
-      const lineEnd = token.start + clipTrailing(text.slice(token.start, token.end)).length;
+      const lineEnd = token.start + clipTrailing(text2.slice(token.start, token.end)).length;
       this.add({
         code: "unclosed-string",
         range: this.range(token.start, lineEnd),
@@ -4660,7 +4664,7 @@ var Analyzer = class {
     }
     if (escapes?.length) {
       const first = escapes[0];
-      const shown = text.slice(first, first + 2);
+      const shown = text2.slice(first, first + 2);
       this.add({
         code: "invalid-escape",
         range: this.range(first, Math.min(token.end, first + 2)),
@@ -4692,9 +4696,9 @@ var Analyzer = class {
             title: "Replace with escape",
             safe: true,
             edits: controls.map((offset) => {
-              const code = text.charCodeAt(offset);
+              const code2 = text2.charCodeAt(offset);
               const named = { 8: "\\b", 9: "\\t", 12: "\\f" };
-              return { offset, length: 1, insert: named[code] ?? `\\u${code.toString(16).padStart(4, "0")}` };
+              return { offset, length: 1, insert: named[code2] ?? `\\u${code2.toString(16).padStart(4, "0")}` };
             })
           }
         ]
@@ -4963,10 +4967,10 @@ var Analyzer = class {
   }
   // -- structural problems --
   missingComma(valueEnd, previous) {
-    const line = this.line(Math.max(valueEnd - 1, 0));
+    const line2 = this.line(Math.max(valueEnd - 1, 0));
     return {
-      message: `Missing comma after ${previous ? `\`${previous.text}\`` : "the previous value"} (line ${line}).`,
-      next: `add \`,\` right after it, on line ${line}.`,
+      message: `Missing comma after ${previous ? `\`${previous.text}\`` : "the previous value"} (line ${line2}).`,
+      next: `add \`,\` right after it, on line ${line2}.`,
       fixes: [{ id: "insert-comma", title: "Insert comma", safe: true, edits: [{ offset: valueEnd, length: 0, insert: "," }], caret: valueEnd + 1 }]
     };
   }
@@ -5049,7 +5053,7 @@ var Analyzer = class {
   }
   /** The edits that remove an entry whose value is missing (key through colon), and the comma that belonged to it. */
   removeEntry(start, end) {
-    const { text } = this;
+    const { text: text2 } = this;
     const firstFrom = (offset) => {
       let low = 0;
       let high = this.tokens.length;
@@ -5070,18 +5074,18 @@ var Analyzer = class {
     let to = end;
     if (first?.kind === "comma") to = first.end;
     else if (!entryFollows(second) && before?.kind === "comma") from = before.start;
-    const alone = from === start && /^[ \t]*$/.test(text.slice(lineBounds(text, start).start, start)) && /^[ \t]*$/.test(text.slice(to, lineBounds(text, Math.max(to - 1, 0)).end));
+    const alone = from === start && /^[ \t]*$/.test(text2.slice(lineBounds(text2, start).start, start)) && /^[ \t]*$/.test(text2.slice(to, lineBounds(text2, Math.max(to - 1, 0)).end));
     if (alone) {
-      const bounds = lineBounds(text, start);
-      let lineEnd = lineBounds(text, Math.max(to - 1, 0)).end;
-      if (text[lineEnd] === "\r" && text[lineEnd + 1] === "\n") lineEnd += 2;
-      else if (lineEnd < text.length) lineEnd++;
+      const bounds = lineBounds(text2, start);
+      let lineEnd = lineBounds(text2, Math.max(to - 1, 0)).end;
+      if (text2[lineEnd] === "\r" && text2[lineEnd + 1] === "\n") lineEnd += 2;
+      else if (lineEnd < text2.length) lineEnd++;
       return [{ offset: bounds.start, length: lineEnd - bounds.start, insert: "" }];
     }
     return [{ offset: from, length: to - from, insert: "" }];
   }
   unclosed(container) {
-    const { text } = this;
+    const { text: text2 } = this;
     const closer = container.type === "{" ? "}" : "]";
     const open = container.open;
     const last = this.last && this.last.start >= open.start ? this.last : open;
@@ -5094,20 +5098,20 @@ var Analyzer = class {
     const removed = dangling ? last.end - last.start : 0;
     const sameLine = this.line(open.start) === this.line(Math.max(last.end - 1, 0));
     const own4 = sameLine ? closer : `
-${indentOf(text, open.start)}${closer}`;
+${indentOf(text2, open.start)}${closer}`;
     const inner = this.cascade.last === this.last && removed === 0 ? this.cascade.inserts : [];
     const insert = inner.join("") + own4;
     this.cascade = { last: this.last, inserts: [...inner, own4] };
     const closers = insert.replace(/\s/g, "");
     const key2 = container.path.at(-1);
-    const entry = typeof key2 === "string" ? `"${key2}": ${open.text}` : open.text;
-    const context = container.type === "{" ? firstEntryOf(text, open) : void 0;
+    const entry2 = typeof key2 === "string" ? `"${key2}": ${open.text}` : open.text;
+    const context = container.type === "{" ? firstEntryOf(text2, open) : void 0;
     const what = container.type === "{" ? "property" : "item";
     this.add({
       code: container.type === "{" ? "unclosed-object" : "unclosed-array",
       range: this.range(open.start, open.end),
       path: [...container.path],
-      message: container.type === "{" ? `The \`${entry}\` on line ${this.line(open.start)}${context ? ` (starting \`${context}\`)` : ""} is never closed.` : `The list \`${entry}\` on line ${this.line(open.start)} is never closed.`,
+      message: container.type === "{" ? `The \`${entry2}\` on line ${this.line(open.start)}${context ? ` (starting \`${context}\`)` : ""} is never closed.` : `The list \`${entry2}\` on line ${this.line(open.start)} is never closed.`,
       next: `add \`${closer}\` after its last ${what}${sameLine ? "" : ", on its own line"}.`,
       fixes: [{ id: "insert-closer", title: `Insert ${closers}`, safe: false, edits: [{ offset: insertAt, length: removed, insert }], caret: insertAt + insert.length }]
     });
@@ -5145,22 +5149,22 @@ function keyName(token) {
 function clipTrailing(value) {
   return value.replace(/[ \t]+$/, "");
 }
-function entryText(text, start, end, kind) {
-  const raw = text.slice(start, end);
+function entryText(text2, start, end, kind) {
+  const raw = text2.slice(start, end);
   if (kind === "object" || kind === "array") {
     const head = raw.slice(0, raw.indexOf(kind === "object" ? "{" : "["));
     return clip(`${head}${kind === "object" ? "{\u2026}" : "[\u2026]"}`, 40);
   }
   return clip(raw, 40);
 }
-function firstEntryOf(text, open) {
-  const rest = text.slice(open.end, open.end + 200);
-  const match = /^\s*("(?:[^"\\\n]|\\.)*"\s*:\s*(?:"(?:[^"\\\n]|\\.)*"|[^\s,{}[\]]+))/.exec(rest);
-  return match?.[1] ? clip(match[1], 36) : void 0;
+function firstEntryOf(text2, open) {
+  const rest = text2.slice(open.end, open.end + 200);
+  const match2 = /^\s*("(?:[^"\\\n]|\\.)*"\s*:\s*(?:"(?:[^"\\\n]|\\.)*"|[^\s,{}[\]]+))/.exec(rest);
+  return match2?.[1] ? clip(match2[1], 36) : void 0;
 }
 function jsonShort(value) {
-  const text = JSON.stringify(value);
-  return text !== void 0 && text.length <= 32 ? text : void 0;
+  const text2 = JSON.stringify(value);
+  return text2 !== void 0 && text2.length <= 32 ? text2 : void 0;
 }
 function exampleOf(info) {
   const example = info.examples.map(jsonShort).find((item) => item !== void 0) ?? (info.enum?.[0] ? jsonShort(info.enum[0].value) : void 0);
@@ -5169,7 +5173,7 @@ function exampleOf(info) {
   return type === "boolean" ? "true" : type === "number" || type === "integer" ? "1" : type === "object" ? "{ \u2026 }" : type === "array" ? "[ \u2026 ]" : '"\u2026"';
 }
 function listValues(values) {
-  const shown = values.slice(0, 5).map((entry) => String(entry.value));
+  const shown = values.slice(0, 5).map((entry2) => String(entry2.value));
   return values.length > 5 ? `one of ${values.length} values (${shown.slice(0, 3).join(", ")}, \u2026)` : `one of ${shown.join(", ")}`;
 }
 function joinAlternatives(items) {
@@ -5253,16 +5257,16 @@ function valueHint(path) {
   }
   return { next, title, insert, caret };
 }
-function analyzeJsonSyntax(text, options = {}) {
-  const limit = Math.max(0, options.limit ?? 5);
-  const analyzer = new Analyzer(String(text ?? ""));
+function analyzeJsonSyntax(text2, options2 = {}) {
+  const limit = Math.max(0, options2.limit ?? 5);
+  const analyzer = new Analyzer(String(text2 ?? ""));
   try {
     analyzer.run();
   } catch {
     return [];
   }
   const seen = /* @__PURE__ */ new Set();
-  return analyzer.problems.sort((a, b) => a.problem.range.offset - b.problem.range.offset || a.order - b.order).map((entry) => entry.problem).filter((problem) => {
+  return analyzer.problems.sort((a, b) => a.problem.range.offset - b.problem.range.offset || a.order - b.order).map((entry2) => entry2.problem).filter((problem) => {
     const id = `${problem.code}:${problem.range.offset}`;
     if (seen.has(id)) return false;
     seen.add(id);
@@ -5353,16 +5357,1613 @@ function parseSource(source) {
   };
 }
 
+// src/finding-text-util.ts
+var WORDS = { object: "an object", array: "a list", string: "text", number: "a number", integer: "a whole number", boolean: "true or false", null: "null" };
+var KIND_WORDS = { layouts: "layout", themes: "theme", colorSchemes: "color scheme", fontSchemes: "font scheme", narratives: "narrative", audiences: "audience", purposes: "purpose", tones: "tone", languages: "language" };
+var KIND_EXAMPLES = { layouts: "`pillars` or `acme:hero`", themes: "`minimal` or `acme:bold`", colorSchemes: "`boost` or `acme:night`", fontSchemes: "`aptos` or `acme:brand`", narratives: "`classic-story`", audiences: "`board`", purposes: "`inform`", tones: "`formal`" };
+var ALIASES = { middle: "center", centre: "center", centered: "center", centred: "center", justify: "left", col: "column", cols: "column", pic: "image", picture: "image", photo: "image", paragraph: "text", bullets: "list", bullet: "list" };
+function segmentsOf(path) {
+  if (Array.isArray(path)) return path.map(String);
+  if (typeof path !== "string" || path === "" || path === "/") return [];
+  return path.replace(/^\//, "").split("/").map((part) => part.replaceAll("~1", "/").replaceAll("~0", "~"));
+}
+function pointerOf(segments) {
+  return segments.map((part) => `/${String(part).replaceAll("~", "~0").replaceAll("/", "~1")}`).join("");
+}
+var code = (value) => `\`${String(value)}\``;
+var isIndex = (segment) => /^\d+$/.test(String(segment));
+function cap(text2) {
+  return text2.startsWith("`") ? text2 : text2.charAt(0).toUpperCase() + text2.slice(1);
+}
+function fieldLabel(segments) {
+  if (!segments.length) return "the deck";
+  const last = segments[segments.length - 1];
+  if (isIndex(last)) {
+    const owner = [...segments].reverse().find((segment) => !isIndex(segment));
+    return owner === "slides" ? `slide ${Number(last) + 1}` : owner ? `${owner} entry ${Number(last) + 1}` : `entry ${Number(last) + 1}`;
+  }
+  return code(last);
+}
+function containerName(segments) {
+  if (!segments.length) return "the deck";
+  if (segments.length === 2 && segments[0] === "slides" && isIndex(segments[1])) return "a slide";
+  const last = segments[segments.length - 1];
+  return isIndex(last) ? fieldLabel(segments) : code(last);
+}
+function describeValue(value) {
+  if (value === void 0) return "missing";
+  if (value === null) return "null";
+  if (Array.isArray(value)) return value.length ? `a list of ${value.length}` : "an empty list";
+  if (typeof value === "object") return "an object";
+  if (typeof value === "string") return value === "" ? "empty" : code(value.length > 30 ? `${value.slice(0, 29)}\u2026` : value);
+  return `${typeof value === "number" ? "a number" : "true or false"} (${code(String(value))})`;
+}
+function describeKind(value) {
+  if (typeof value === "string") return value === "" ? "empty text" : `text (${describeValue(value)})`;
+  return describeValue(value);
+}
+function typeWords(type) {
+  const list = (Array.isArray(type) ? type : [type]).filter(Boolean).map((entry2) => WORDS[String(entry2)] ?? String(entry2));
+  return [...new Set(list)].join(" or ") || "a different kind of value";
+}
+function distance2(a, b) {
+  const x = a.toLowerCase();
+  const y = b.toLowerCase();
+  if (x === y) return 0;
+  const row = Array.from({ length: y.length + 1 }, (_, index) => index);
+  for (let i = 1; i <= x.length; i++) {
+    let previous = row[0];
+    row[0] = i;
+    for (let j = 1; j <= y.length; j++) {
+      const keep3 = row[j];
+      row[j] = Math.min(row[j] + 1, row[j - 1] + 1, previous + (x[i - 1] === y[j - 1] ? 0 : 1));
+      previous = keep3;
+    }
+  }
+  return row[y.length];
+}
+function nearest(value, candidates, limit = 5) {
+  const text2 = String(value ?? "");
+  const alias = ALIASES[text2.toLowerCase()];
+  const ranked = candidates.map((candidate) => ({ candidate, score: String(candidate).toLowerCase() === alias ? 0 : distance2(text2, String(candidate)) }));
+  ranked.sort((a, b) => a.score - b.score);
+  const close = ranked.filter((entry2) => entry2.score <= Math.max(2, Math.floor(text2.length / 4))).map((entry2) => entry2.candidate);
+  return { close: close.slice(0, limit), all: ranked.map((entry2) => entry2.candidate) };
+}
+function valueList(values, max = 5) {
+  const list = values.map((value) => typeof value === "string" ? value : JSON.stringify(value));
+  if (list.length <= max) return list.length > 1 ? `${list.slice(0, -1).join(", ")} or ${list.at(-1)}` : list.join("");
+  return `one of ${list.length} values (${list.slice(0, 3).join(", ")}, \u2026)`;
+}
+var firstSentence = (text2) => /^.*?[.!?](?=\s|$)/.exec(String(text2 ?? "").replace(/\s+/g, " ").trim())?.[0] ?? "";
+function asNext(text2) {
+  const trimmed = text2.trim();
+  return /^[A-Z][a-z]/.test(trimmed) ? trimmed.charAt(0).toLowerCase() + trimmed.slice(1) : trimmed;
+}
+var isRecord2 = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+function readAt(document, segments) {
+  let value = document;
+  for (const segment of segments) {
+    if (Array.isArray(value)) value = value[Number(segment)];
+    else if (isRecord2(value)) value = value[segment];
+    else return void 0;
+  }
+  return value;
+}
+
+// src/finding-text-helpers.ts
+var ENDS = /[.?!]$/;
+function sentence(text2) {
+  const trimmed = text2.trim();
+  return ENDS.test(trimmed) ? trimmed : `${trimmed}.`;
+}
+function us(text2) {
+  return text2.replace(/colour/g, "color").replace(/Colour/g, "Color");
+}
+var keep = (text2) => sentence(us(text2));
+function match(text2, regex) {
+  return regex.exec(text2) ?? void 0;
+}
+function unquote(text2) {
+  if (text2 === void 0) return "";
+  try {
+    const value = JSON.parse(text2);
+    if (typeof value === "string") return value;
+  } catch {
+  }
+  return text2.replace(/^['"]|['"]$/g, "");
+}
+function unquoteList(text2) {
+  if (text2 === void 0) return [];
+  try {
+    const value = JSON.parse(`[${text2}]`);
+    if (Array.isArray(value) && value.every((entry2) => typeof entry2 === "string")) return value;
+  } catch {
+  }
+  return text2.split(/,\s*/).map((entry2) => entry2.replace(/^['"]|['"]$/g, "").trim()).filter((entry2) => entry2 && entry2 !== "...");
+}
+function slideNumber(finding2) {
+  if (finding2.slide !== void 0) return finding2.slide + 1;
+  const found = /^\/slides\/(\d+)(?:\/|$)/.exec(finding2.path);
+  return found ? Number(found[1]) + 1 : void 0;
+}
+var slideWord = (finding2) => {
+  const number = slideNumber(finding2);
+  return number === void 0 ? void 0 : `slide ${number}`;
+};
+var onSlide = (finding2) => {
+  const word = slideWord(finding2);
+  return word ? ` on ${word}` : "";
+};
+function slideRef(finding2, helpers) {
+  const number = slideNumber(finding2);
+  if (number === void 0) return "The deck";
+  const id = finding2.slideId ?? helpers.valueAt(["slides", String(number - 1), "id"]);
+  if (typeof id === "string" && id) return `Slide ${number} (${code(id)})`;
+  const layout = helpers.valueAt(["slides", String(number - 1), "layout"]);
+  if (typeof layout === "string" && layout) return `Slide ${number} (layout ${code(layout)})`;
+  return `Slide ${number}`;
+}
+var lastName = (segments) => [...segments].reverse().find((segment) => !isIndex(segment));
+function dotted(segments) {
+  return segments.reduce((out, segment) => isIndex(segment) ? `${out}[${segment}]` : out ? `${out}.${segment}` : segment, "");
+}
+function keysAt(helpers, path) {
+  const value = helpers.valueAt(path);
+  return isRecord2(value) ? Object.keys(value) : [];
+}
+function idsAt(helpers, path) {
+  const value = helpers.valueAt(path);
+  return Array.isArray(value) ? value.flatMap((entry2) => isRecord2(entry2) && typeof entry2.id === "string" ? [entry2.id] : []) : [];
+}
+function codeList(names2, max = 5, joiner = "and") {
+  const shown = names2.slice(0, max).map(code);
+  const rest = names2.length - shown.length;
+  if (rest > 0) return `${shown.join(", ")} and ${rest} more`;
+  return shown.length > 1 ? `${shown.slice(0, -1).join(", ")} ${joiner} ${shown.at(-1)}` : shown.join("");
+}
+function plainList(names2, max = 6) {
+  const shown = names2.slice(0, max);
+  const rest = names2.length - shown.length;
+  return rest > 0 ? `${shown.join(", ")} and ${rest} more` : shown.join(", ");
+}
+function andList(names2, max = 6) {
+  const shown = names2.slice(0, max);
+  const rest = names2.length - shown.length;
+  if (rest > 0) return `${shown.join(", ")} and ${rest} more`;
+  return shown.length > 1 ? `${shown.slice(0, -1).join(", ")} and ${shown.at(-1)}` : shown.join("");
+}
+function chooseNext(value, candidates, alternative = "", max = 3) {
+  const { close } = nearest(value, candidates);
+  const or = alternative ? ` Or ${alternative}.` : "";
+  if (close.length) return `did you mean ${code(close[0])}?${or}`;
+  if (candidates.length === 1) return `use ${code(candidates[0])}${alternative ? `, or ${alternative}` : ""}.`;
+  if (candidates.length) return `pick one of ${codeList(candidates, max, "or")}${alternative ? `, or ${alternative}` : ""}.`;
+  return alternative ? sentence(alternative) : "choose a different value.";
+}
+function kindPhrase(kind) {
+  const phrases = { text: "text", code: "code", list: "a list", chart: "a chart", table: "a table", image: "an image", video: "a video", metric: "a metric", quote: "a quote", timeline: "a timeline", group: "a group" };
+  return phrases[kind] ?? `${/^[aeiou]/i.test(kind) ? "an" : "a"} ${kind}`;
+}
+function freshName(base, taken = []) {
+  const space = /\s/.test(base);
+  for (let n = 2; n < 100; n++) {
+    const candidate = space ? `${base} ${n}` : `${base}-${n}`;
+    if (!taken.includes(candidate)) return candidate;
+  }
+  return `${base}-2`;
+}
+var BLOCK_KINDS = ["chart", "image", "video", "table", "code", "metric", "quote", "timeline", "items", "bullets", "text"];
+function blockKind(node) {
+  if (!isRecord2(node)) return void 0;
+  if (typeof node.type === "string" && node.type !== "group") return node.type;
+  const found = BLOCK_KINDS.find((key2) => node[key2] !== void 0);
+  if (found === "items" || found === "bullets") return "list";
+  return found;
+}
+function helpAsNext(finding2, fallback) {
+  const help = finding2.help?.trim();
+  return help ? sentence(asNext(us(help))) : fallback;
+}
+var isText2 = (value) => typeof value === "string" && value !== "";
+function brief(text2, max = 40) {
+  const flat = text2.replace(/\s+/g, " ").trim();
+  return flat.length > max ? `${flat.slice(0, max - 1)}\u2026` : flat;
+}
+
+// src/finding-text-audit.ts
+var measuredNumber = (finding2, key2) => {
+  const value = finding2.measured?.[key2];
+  return typeof value === "number" ? value : void 0;
+};
+var measuredText = (finding2, key2) => {
+  const value = finding2.measured?.[key2];
+  return typeof value === "string" ? value : void 0;
+};
+var num = (value, digits = 2) => String(Math.round(value * 10 ** digits) / 10 ** digits);
+var textContrast = (finding2) => {
+  const ratio = measuredNumber(finding2, "ratio");
+  const needed = measuredNumber(finding2, "needed");
+  const foreground = measuredText(finding2, "textColor");
+  const background = measuredText(finding2, "backgroundColor");
+  if (ratio === void 0 || needed === void 0) return void 0;
+  const label = match(finding2.message, /^(.+?) colou?r /)?.[1];
+  const subject = label && !/^(Text|Colou?red text)$/.test(label) ? us(label) : "Text";
+  const colors = foreground && background ? ` ${code(foreground)} on ${code(background)}` : "";
+  const large = finding2.measured?.large === true ? " for large text" : finding2.measured?.large === false ? " for normal-size text" : "";
+  const also = measuredNumber(finding2, "alsoAffected");
+  const fix = finding2.fixes?.find((entry2) => entry2.id === "use-readable-color");
+  const replacement = fix?.kind === "patch" && fix.patch?.[0] && "value" in fix.patch[0] ? fix.patch[0].value : void 0;
+  const overrides = finding2.path.endsWith("/color");
+  return {
+    message: `${subject}${colors} has contrast ${num(ratio)}:1; WCAG needs ${num(needed)}:1${large}.${also ? ` ${also} more text element${also === 1 ? "" : "s"} on this slide ${also === 1 ? "has" : "have"} the same problem.` : ""}`,
+    next: typeof replacement === "string" ? replacement === "text" ? `use ${code("text")}, the slide's text color, which is readable here.` : `use ${code(replacement)}, which is readable here.` : overrides ? "pick a color with more contrast against the background, or remove the override so the theme chooses a readable one." : "change the slide background or the color scheme, or give the text an explicit readable color."
+  };
+};
+var textOnImage = (finding2) => {
+  const ratio = measuredNumber(finding2, "ratio");
+  const needed = measuredNumber(finding2, "needed");
+  return {
+    message: `Contrast over this picture can't be measured${ratio !== void 0 && needed !== void 0 ? `: against the lightest or darkest possible pixels it is as low as ${num(ratio, 1)}:1, and ${num(needed)}:1 is needed` : ""}.`,
+    next: `add a full-frame ${code("overlay")} to the background image, so the text stays readable on any picture.`
+  };
+};
+var ALT_SUBJECT = {
+  Image: "This image",
+  Video: "This video",
+  "Header/footer image": "This header or footer image",
+  "Speaker photo": "This speaker photo",
+  "Quote photo": "This quote photo",
+  "Organization logo": "This organization logo",
+  Picture: "This picture"
+};
+var missingAltText = (finding2) => {
+  const found = match(finding2.message, /^(.+?) has (no|blank) alt text\.$/);
+  if (!found) return void 0;
+  const subject = ALT_SUBJECT[found[1]] ?? `This ${found[1].toLowerCase()}`;
+  return {
+    message: `${subject} has ${found[2] === "blank" ? "blank" : "no"} alt text.`,
+    next: `describe it in ${code("alt")}, or write ${code('alt: ""')} if it is only decoration.`
+  };
+};
+var poorAltText = (finding2) => {
+  const found = match(finding2.message, /^(?:(Chart) |(.+?) )?alt text ("(?:[^"\\]|\\.)*") (.+)\.$/);
+  if (!found) return void 0;
+  const alt = unquote(found[3]);
+  const chart = found[1] === "Chart";
+  const problem = found[4].replace(/^is a generic word, not what the data shows$/, "is a generic word");
+  return {
+    message: `Alt text ${code(brief(alt, 50))} ${us(problem)}, so it doesn't describe the ${chart ? "chart" : "picture"}.`,
+    next: chart ? "state what the chart shows: its point and the key numbers, in a sentence or two." : `describe what the picture shows, in plain words and without a leading "image of".`
+  };
+};
+var missingSlideTitle = (finding2, _context, helpers) => ({
+  message: `${slideRef(finding2, helpers)} has no title, and screen reader users find slides by title.`,
+  next: `write a ${code("title")} for it.`
+});
+var duplicateSlideTitle = (finding2) => {
+  const found = match(finding2.message, /^Slide (\d+) has the same title as slide (\d+): ("(?:[^"\\]|\\.)*")\.$/);
+  if (!found) return void 0;
+  return {
+    message: `Slides ${found[2]} and ${found[1]} share the title ${code(unquote(found[3]))}.`,
+    next: "give one of them a title that tells it apart, so people can find each slide by title."
+  };
+};
+var readingOrder = (finding2) => {
+  const above = match(finding2.message, /^Content ("(?:[^"\\]|\\.)*") is drawn above the title but is read after it\.$/);
+  if (above) {
+    return {
+      message: `${code(unquote(above[1]))} is drawn above the title but is read after it${onSlide(finding2)}.`,
+      next: "move the title above the content, or choose a layout that puts the title first."
+    };
+  }
+  const found = match(finding2.message, /^Reading order differs from visual order: ("(?:[^"\\]|\\.)*") is read at (position \d+) but appears at (position \d+)\./);
+  if (!found) return void 0;
+  return {
+    message: `${code(unquote(found[1]))} is read at ${found[2]} but appears at ${found[3]}${onSlide(finding2)}, so a screen reader reads the slide out of order.`,
+    next: "reorder the blocks so the reading order follows what people see, or pin them to layout regions."
+  };
+};
+var linkText = (finding2) => {
+  const found = match(finding2.message, /^Link text ("(?:[^"\\]|\\.)*") (is blank|is generic|is a long raw URL); the destination is (.+)\.$/);
+  if (!found) return void 0;
+  const text2 = unquote(found[1]);
+  const destination = found[3];
+  const message = found[2] === "is blank" ? "The link text is blank, so a screen reader announces only that there is a link." : found[2] === "is generic" ? `The link text ${code(brief(text2, 40))} doesn't say where it goes.` : "The link text is a long raw web address, which a screen reader reads out character by character.";
+  return { message, next: `say what is at ${destination}, for example the page or file name.` };
+};
+var chartColorOnly = (finding2) => {
+  const parts2 = match(finding2.message, /^(Series|Slices) may be hard to tell apart without colou?r/);
+  const noun = parts2?.[1] === "Slices" ? "slices" : "series";
+  const pairs = measuredNumber(finding2, "confusablePairs");
+  const repeat = match(finding2.message, /(\d+) (?:series|slices) exceed the (\d+)-colou?r palette/);
+  const count = measuredNumber(finding2, "series");
+  const message = pairs !== void 0 ? `Some ${noun} differ by color only: ${pairs === 1 ? "one pair looks" : `${pairs} pairs look`} alike to color-blind viewers or in grayscale.${repeat ? ` ${repeat[1]} ${noun} exceed the ${repeat[2]}-color palette, so colors repeat.` : ""}` : `${cap(noun)} differ by color only${count !== void 0 ? ` (${count} ${noun})` : ""}.`;
+  return { message, next: `add data labels or a direct legend, choose more distinct ${code("colors")}, or show fewer ${noun}.` };
+};
+var chartColorsAdjusted = (finding2, _context, helpers) => {
+  const index = match(finding2.message, /^Chart colou?r (\d+) /)?.[1] ?? (isText2(helpers.segments.at(-1)) ? String(Number(helpers.segments.at(-1)) + 1) : void 0);
+  const value = helpers.valueAt(helpers.segments);
+  const shown = typeof value === "string" ? value : unquote(match(finding2.message, /^Chart colou?r \d+ \((.+?)\) /)?.[1]);
+  const contrast = measuredNumber(finding2, "contrast");
+  const panel = measuredText(finding2, "panel");
+  const label = index ? `Chart color ${index}` : "A chart color";
+  if (/cannot be resolved/.test(finding2.message)) {
+    return {
+      message: `${label} (${code(shown)}) can't be resolved, so the palette color of that position is used.`,
+      next: `write a hex color like ${code("#1F4E79")}, a scheme color such as ${code("accent1")}, or a ${code("var:")} reference to a declared variable.`
+    };
+  }
+  if (contrast === void 0) return void 0;
+  return {
+    message: `${label} (${code(shown)}) has ${num(contrast, 1)}:1 contrast against the chart panel${panel ? ` (${code(panel)})` : ""}, so it is drawn lighter or darker to reach 3:1.`,
+    next: `pick a color with at least 3:1 contrast against ${panel ? code(panel) : "the panel"}, or remove ${code("colors")} to use the palette.`
+  };
+};
+var chartTextAlternative = (finding2) => {
+  const where = match(finding2.message, /^The (.+?) (?:has no alt text|is marked decorative)/)?.[1] ?? "chart";
+  if (/is marked decorative/.test(finding2.message)) {
+    return {
+      message: `The ${where} is marked decorative (empty ${code("alt")}), so assistive technology skips it.`,
+      next: `write a sentence in ${code("alt")} if the chart carries information that people need.`
+    };
+  }
+  return {
+    message: `The ${where} has no text alternative.`,
+    next: `write the message it carries in ${code("alt")}, or add text beside it that states what it shows.`
+  };
+};
+var missingLanguage = (_finding, context, helpers) => ({
+  message: "The deck doesn't declare its language.",
+  next: (context.format ?? helpers.format) === "json" ? `add ${code('"language": "en-US"')} (or the language the text is written in) to the deck.` : `add ${code("language: en-US")} (or the language the text is written in) to the deck.`
+});
+var chartOptionAdapted = (finding2, _context, helpers) => {
+  const at2 = helpers.segments.indexOf("chart");
+  const option = at2 >= 0 ? helpers.segments.slice(at2 + 1).join(".") : lastName(helpers.segments) ?? "";
+  if (!option) return void 0;
+  const type = at2 >= 0 ? helpers.valueAt([...helpers.segments.slice(0, at2 + 1), "type"]) : void 0;
+  const typeName = typeof type === "string" ? type : match(finding2.message, /^A '(.+?)' chart/)?.[1];
+  const adaptation = finding2.message.includes(";") ? cap(us(finding2.message.slice(finding2.message.indexOf(";") + 1).trim())) : "";
+  return {
+    message: `${code(option)} isn't supported by ${typeName ? `a ${typeName}` : "this"} chart and is adapted.${adaptation ? ` ${sentence(adaptation)}` : ""}`,
+    next: `remove ${code(option)}, or choose a chart type that can show it.`
+  };
+};
+var textOverflow = (finding2) => {
+  const message = finding2.message;
+  let subject = `Text${onSlide(finding2)} doesn't fit at the smallest allowed size.`;
+  const footnote = match(message, /^Footnote (\d+) does not fit/);
+  if (/^The caption does not fit/.test(message)) subject = `The caption${onSlide(finding2)} doesn't fit its band at the smallest allowed size.`;
+  else if (footnote) subject = `Footnote ${footnote[1]}${onSlide(finding2)} doesn't fit the footnote area.`;
+  return { message: subject, next: "shorten it, split the slide, or choose a roomier layout." };
+};
+var unresolvedContent = (finding2) => ({
+  message: keep(finding2.message),
+  next: "supply what the message asks for, or remove the setting that can't be honored."
+});
+var layoutFailed = (finding2, _context, helpers) => {
+  const reason = match(finding2.message, /^Layout failed: (.+)$/)?.[1];
+  return {
+    message: `${slideRef(finding2, helpers)} couldn't be laid out${reason ? `: ${sentence(us(reason)).replace(/\.$/, "")}` : ""}, so the geometry checks were skipped.`,
+    next: "fix the composition setting or content named above."
+  };
+};
+var minFontSize = (finding2) => {
+  const size = measuredNumber(finding2, "sizePt");
+  const minimum = measuredNumber(finding2, "minimumPt");
+  if (size === void 0 || minimum === void 0) return void 0;
+  const run = /^Text run is set to/.test(finding2.message);
+  const label = run ? "A text run" : match(finding2.message, /^(.+?) is drawn at/)?.[1] ?? "Text";
+  return {
+    message: `${cap(us(label))}${onSlide(finding2)} ${run ? "is set to" : "is drawn at"} ${num(size, 1)} pt, below the ${num(minimum, 1)} pt readable minimum.`,
+    next: run ? `raise ${code("fontSize")} to at least ${num(minimum, 1)}.` : "shorten the text, give it more room or split the slide, so it can be drawn larger."
+  };
+};
+function regionNamesOf(slideLayout, helpers) {
+  if (typeof slideLayout !== "string" || !slideLayout) return void 0;
+  const colon = slideLayout.indexOf(":");
+  const group = colon > 0 ? slideLayout.slice(0, colon) : void 0;
+  const id = colon > 0 ? slideLayout.slice(colon + 1) : slideLayout;
+  const record = (group ? [group] : ["custom", "default"]).map((name) => helpers.valueAt(["catalogs", name, "layouts", id])).find(isRecord2);
+  if (!record) return void 0;
+  const names2 = [];
+  const walk2 = (list) => {
+    if (!Array.isArray(list)) return;
+    for (const entry2 of list) {
+      if (!isRecord2(entry2)) continue;
+      if (typeof entry2.name === "string" && !["title", "subtitle", "tag"].includes(entry2.name)) names2.push(entry2.name);
+      walk2(entry2.regions);
+    }
+  };
+  walk2(record.regions);
+  return { id: slideLayout, names: names2 };
+}
+var regionUnknown = (finding2, _context, helpers) => {
+  const region = match(finding2.message, /^The layout has no region '(.+?)'/)?.[1];
+  if (!region) return void 0;
+  const slide = slideNumber(finding2);
+  const layout = slide ? regionNamesOf(helpers.valueAt(["slides", String(slide - 1), "layout"]), helpers) : void 0;
+  const known = layout?.names ?? [];
+  return {
+    message: layout ? `Block pinned to region ${code(region)}; layout ${code(layout.id)} has ${andList(known)}.` : `A block is pinned to region ${code(region)}, which the slide's layout doesn't have.`,
+    next: known.length ? chooseNext(region, known, `remove ${code("region")}`) : `pin it to a region the layout has, or remove ${code("region")}.`
+  };
+};
+var regionKind = (finding2) => {
+  const found = match(finding2.message, /^Region '(.+?)' does not accept (\S+) content \(it accepts (.+?)\)/);
+  if (!found) return void 0;
+  return {
+    message: `Region ${code(found[1])} doesn't take ${found[2]} content (it takes ${found[3]}).`,
+    next: `remove ${code("region")} so OPF places the block by its kind, or pin it to a region that takes ${found[2]}.`
+  };
+};
+var regionFull = (finding2) => {
+  const found = match(finding2.message, /^Region '(.+?)' already holds its (\d+) block/);
+  if (!found) return void 0;
+  return {
+    message: `Region ${code(found[1])} already holds ${found[2]} block${found[2] === "1" ? "" : "s"}, which is all it takes.`,
+    next: `pin the block to another region with room, or remove ${code("region")}.`
+  };
+};
+var layoutUnplaced = (finding2, _context, helpers) => {
+  const kind = blockKind(helpers.valueAt(helpers.segments));
+  const what = kind ? `this ${kind} block` : "this block";
+  const overflow = match(finding2.message, /drawn in '(.+?)' beyond its (\d+) block/);
+  return {
+    message: overflow ? `No region has room for ${what}; it is drawn in ${code(overflow[1])}, beyond its ${overflow[2]} block${overflow[2] === "1" ? "" : "s"}.` : `No region has room for ${what}; it is drawn in the overflow area.`,
+    next: "paginate the slide, choose a layout with more room, or remove a block."
+  };
+};
+var furnitureWraps = (finding2) => {
+  const found = match(finding2.message, /^The (.+?) text wraps onto (\d+) lines? \(at most (\d+)\)/);
+  const lines = measuredNumber(finding2, "lines") ?? (found ? Number(found[2]) : void 0);
+  const most = measuredNumber(finding2, "maximumLines") ?? (found ? Number(found[3]) : void 0);
+  const zone = found?.[1] ?? "header or footer";
+  if (lines === void 0) return void 0;
+  return {
+    message: `The ${zone} text wraps onto ${lines} lines${most !== void 0 ? ` (${most} at most)` : ""}; headers and footers should be short.`,
+    next: "shorten it, or move part of it to another zone."
+  };
+};
+var fontOutsideScheme = (finding2) => {
+  const found = match(finding2.message, /^Text uses ("(?:[^"\\]|\\.)*"), which is not in the font scheme \((.+)\)\.$/);
+  if (!found) return void 0;
+  return {
+    message: `${code(unquote(found[1]))} isn't in this deck's font scheme (${found[2]}), so it won't follow a scheme change.`,
+    next: `remove ${code("fontFamily")} to use the scheme font, or add the font to the font scheme.`
+  };
+};
+var imageResolution = (finding2) => {
+  const width = measuredNumber(finding2, "widthPx");
+  const height = measuredNumber(finding2, "heightPx");
+  const ppi = measuredNumber(finding2, "ppi");
+  const minimum = measuredNumber(finding2, "minimumPpi");
+  if (width === void 0 || height === void 0 || ppi === void 0) return void 0;
+  const shown = match(finding2.message, /shown ([\d.]+) x ([\d.]+) in/);
+  const needed = shown && minimum !== void 0 ? ` about ${Math.ceil(Number(shown[1]) * minimum)}\xD7${Math.ceil(Number(shown[2]) * minimum)} px` : "";
+  return {
+    message: `This image is ${width}\xD7${height} px, shown at about ${ppi} ppi${minimum !== void 0 ? `; ${minimum} are needed to look sharp` : ""}.`,
+    next: needed ? `use a file of${needed} or larger, or show it smaller.` : "use a larger file, or show the image smaller."
+  };
+};
+var chartValueNotNumeric = (finding2) => {
+  const value = unquote(match(finding2.message, /^chart value ("(?:[^"\\]|\\.)*") is not a number/)?.[1]);
+  const fix = finding2.fixes?.find((entry2) => entry2.id === "store-chart-numbers");
+  if (!value) return void 0;
+  return {
+    message: `${code(value)} is text, so it is plotted as a gap.`,
+    next: fix ? `${sentence((fix.title.charAt(0).toLowerCase() + fix.title.slice(1)).replace(/\.$/, ""))}` : `write a number (12, -3.5, 1e6) and put units, currency or percent in the column ${code("format")}.`
+  };
+};
+var chartMappingAdapted = (finding2) => ({
+  message: keep(cap(finding2.message)),
+  next: "remove that mapping entry, or name a different column."
+});
+var chartHighlightAdapted = (finding2) => {
+  const name = unquote(match(finding2.message, /^highlight names \w+ ("(?:[^"\\]|\\.)*"), which is not plotted as a series/)?.[1]);
+  if (!name) return void 0;
+  return {
+    message: `${code(name)} is not plotted as a series, so highlighting it changes nothing. It is the category or X column, or the mapping leaves it out.`,
+    next: "name a series the chart plots, or remove the entry."
+  };
+};
+var codeHighlightOutOfRange = (finding2) => {
+  const found = match(finding2.message, /line (\d+) is past the last line \(the code has (\d+) lines?\)/);
+  if (!found) return void 0;
+  return {
+    message: `Highlight line ${found[1]} is past the last line (${found[2]}), so it marks nothing.`,
+    next: `change it to a line from 1 to ${found[2]}, or remove the entry.`
+  };
+};
+var codeHighlightRangeReversed = (finding2) => {
+  const found = match(finding2.message, /^The highlight range \[(\d+), (\d+)\] ends before it starts.*write \[(\d+), (\d+)\]/);
+  if (!found) return void 0;
+  return {
+    message: `Highlight ${found[1]}\u2013${found[2]} ends before it starts, so it marks no line.`,
+    next: `write [${found[3]}, ${found[4]}].`
+  };
+};
+var variableBuiltinMissing = (finding2, _context, helpers) => {
+  const idParam = isRecord2(finding2.validation?.params) ? finding2.validation.params.id : void 0;
+  const id = (typeof idParam === "string" ? idParam : void 0) ?? match(finding2.message, /^Built-in '(.+?)' has no value/)?.[1] ?? match(finding2.message, /'\{\{(.+?)\}\}'/)?.[1];
+  if (!id) return void 0;
+  const root = id.split(".")[0];
+  const field = id.split(".").at(-1) ?? id;
+  const token = code(`{{${id}}}`);
+  if (id === "slide.section") return { message: `${token} has no value: ${slideRef(finding2, helpers)} has no section.`, next: `give the slide a ${code("section")}, or remove the token.` };
+  if (root === "deck") return { message: `${token} has no value in this document.`, next: `add ${code(field)} to the deck.` };
+  if (id === "speakers") return { message: `${token} has no value in this document.`, next: `add a ${code("speaker")} with a ${code("name")}.` };
+  if (root === "speaker" || root === "organization") return { message: `${token} has no value in this document.`, next: `add ${code(field)} to ${code(root)}.` };
+  return { message: `${token} has no value in this document.`, next: "add the field it reads." };
+};
+var durationOutsideNarrative2 = (finding2) => {
+  const found = match(finding2.message, /^The target duration of (\d+(?:\.\d+)?) minutes is outside the (.+?) narrative ("(?:[^"\\]|\\.)*") suits\.$/);
+  if (!found) return void 0;
+  return {
+    message: `A ${found[1]}-minute deck is outside the ${found[2]} minutes that narrative ${code(unquote(found[3]))} suits.`.replace("minutes minutes", "minutes"),
+    next: `change ${code("duration")}, or choose a narrative that suits ${found[1]} minutes.`
+  };
+};
+var narrativeDurationRange = (_finding, _context, helpers) => {
+  const range = helpers.valueAt(helpers.segments);
+  if (isRecord2(range) && typeof range.min === "number" && typeof range.max === "number") {
+    return {
+      message: `The duration range has min ${range.min} greater than max ${range.max}.`,
+      next: `swap them: ${code(`min: ${range.max}`)} and ${code(`max: ${range.min}`)}.`
+    };
+  }
+  return { message: "The duration range has min greater than max.", next: `swap ${code("min")} and ${code("max")}.` };
+};
+var placeholderText = (finding2) => {
+  const found = match(finding2.message, /^Text looks like (.+?): ("(?:[^"\\]|\\.)*")\.$/);
+  if (!found) return void 0;
+  return {
+    message: `${code(brief(unquote(found[2]), 50))} looks like placeholder text (${found[1]}).`,
+    next: "replace it with the real text."
+  };
+};
+var emptyText = (finding2) => {
+  const what = match(finding2.message, /^The (.+) is empty\.$/)?.[1];
+  if (!what) return void 0;
+  return {
+    message: `The ${what}${onSlide(finding2)} is empty.`,
+    next: `write the text, or remove the empty ${what}.`
+  };
+};
+var unusedBeat = (finding2, _context, helpers) => {
+  const beat = measuredText(finding2, "beat");
+  const position = measuredNumber(finding2, "position");
+  const beats = measuredNumber(finding2, "beats");
+  if (!beat) return void 0;
+  const narrative = isText2(helpers.valueAt(["narrative"])) ? String(helpers.valueAt(["narrative"])) : unquote(match(finding2.message, /of narrative ("(?:[^"\\]|\\.)*")/)?.[1]);
+  return {
+    message: `Beat ${code(beat)}${position !== void 0 && beats !== void 0 ? ` (${position} of ${beats})` : ""} of narrative ${code(narrative)} has no slide.`,
+    next: `give a slide ${code(`beat: "${beat}"`)}, or ignore this if the beat is optional.`
+  };
+};
+var emptySlide = (finding2, _context, helpers) => ({
+  message: `${slideRef(finding2, helpers)} has no content.`,
+  next: `add content or a ${code("title")}, remove the slide, or give it the ${code("blank")} layout if it is meant to be empty.`
+});
+var languageTag = (finding2, _context, helpers) => {
+  const value = helpers.valueAt(helpers.segments);
+  const tag = typeof value === "string" ? value : match(finding2.message, /^'(.+?)'/)?.[1];
+  if (!tag) return void 0;
+  const fix = finding2.fixes?.find((entry2) => entry2.id === "use-canonical-tag");
+  const replacement = fix?.kind === "patch" && fix.patch?.[0] && "value" in fix.patch[0] && typeof fix.patch[0].value === "string" ? fix.patch[0].value : match(finding2.help ?? "", /^Write '(.+?)'\.$/)?.[1];
+  const region = match(finding2.message, /names the region '(.+?)', which is not an assigned region/)?.[1];
+  const reason = /not a well-formed/.test(finding2.message) ? "is not a well-formed language tag" : region ? `is not a valid tag: ${code(region)} is not an assigned region` : /not in canonical case/.test(finding2.message) ? "is not in canonical case" : /deprecated/.test(finding2.message) ? "uses a deprecated region" : "is not a valid language tag";
+  return {
+    message: `${code(tag)} ${reason}.`,
+    next: replacement ? `did you mean ${code(replacement)}?` : `write a tag like ${code("en-US")}, ${code("pt-BR")} or ${code("es-419")}.`
+  };
+};
+var AUDIT_TEXT = {
+  "opf/text-contrast": textContrast,
+  "opf/text-on-image": textOnImage,
+  "opf/missing-alt-text": missingAltText,
+  "opf/poor-alt-text": poorAltText,
+  "opf/missing-slide-title": missingSlideTitle,
+  "opf/duplicate-slide-title": duplicateSlideTitle,
+  "opf/reading-order": readingOrder,
+  "opf/link-text": linkText,
+  "opf/chart-color-only": chartColorOnly,
+  "opf/chart-colors-adjusted": chartColorsAdjusted,
+  "opf/chart-text-alternative": chartTextAlternative,
+  "opf/missing-language": missingLanguage,
+  "opf/chart-option-adapted": chartOptionAdapted,
+  "opf/text-overflow": textOverflow,
+  "opf/unresolved-content": unresolvedContent,
+  "opf/layout-failed": layoutFailed,
+  "opf/min-font-size": minFontSize,
+  "opf/region-unknown": regionUnknown,
+  "opf/region-kind": regionKind,
+  "opf/region-full": regionFull,
+  "opf/layout-unplaced": layoutUnplaced,
+  "opf/furniture-wraps": furnitureWraps,
+  "opf/font-outside-scheme": fontOutsideScheme,
+  "opf/image-resolution": imageResolution,
+  "opf/chart-value-not-numeric": chartValueNotNumeric,
+  "opf/chart-mapping-adapted": chartMappingAdapted,
+  "opf/chart-highlight-adapted": chartHighlightAdapted,
+  "opf/code-highlight-out-of-range": codeHighlightOutOfRange,
+  "opf/code-highlight-range-reversed": codeHighlightRangeReversed,
+  "opf/variable-builtin-missing": variableBuiltinMissing,
+  "opf/duration-outside-narrative": durationOutsideNarrative2,
+  "opf/narrative-duration-range": narrativeDurationRange,
+  "opf/placeholder-text": placeholderText,
+  "opf/empty-text": emptyText,
+  "opf/unused-beat": unusedBeat,
+  "opf/empty-slide": emptySlide,
+  "opf/language-tag": languageTag
+};
+
+// src/finding-text-format.ts
+var params = (finding2) => isRecord2(finding2.validation?.params) ? finding2.validation.params : {};
+var text = (value) => typeof value === "string" ? value : void 0;
+var jsonSyntax = (finding2) => ({
+  message: keep(finding2.message),
+  next: helpAsNext(finding2, "fix the syntax error at the marked position.")
+});
+var duplicateKey = (finding2, _context, helpers) => {
+  const key2 = helpers.segments.at(-1) ?? unquote(match(finding2.message, /^Duplicate JSON property (".*")\.$/)?.[1]);
+  const owner = helpers.segments.length > 1 ? `in ${code(helpers.segments.at(-2))}` : "in this object";
+  return {
+    message: `${code(key2)} appears twice ${owner}. JSON keeps only the last value, so the earlier one is ignored.`,
+    next: "keep one of them, or merge their values into one."
+  };
+};
+var schemaPlain = (finding2) => ({
+  message: keep(finding2.message),
+  next: helpAsNext(finding2, "check the schema reference for this field.")
+});
+var referenceIdDuplicate = (finding2, _context, helpers) => {
+  const id = text(params(finding2).id) ?? unquote(match(finding2.message, /^reference id '(.+?)' is used/)?.[1]);
+  const ids = idsAt(helpers, ["references"]);
+  const index = Number(helpers.segments[1]);
+  const first = ids.indexOf(id);
+  const where = first >= 0 && Number.isInteger(index) && first !== index ? ` (references ${first + 1} and ${index + 1})` : "";
+  return {
+    message: `Two references use the id ${code(id)}${where}.`,
+    next: `give the later one another id (for example ${code(freshName(id, ids))}); runs cite references by id.`
+  };
+};
+var citeUnknownReference = (finding2, _context, helpers) => {
+  const id = text(params(finding2).id) ?? unquote(match(finding2.message, /^unknown reference '(.+?)'/)?.[1]);
+  const ids = idsAt(helpers, ["references"]);
+  const add = `add a reference with the id ${code(id)} under ${code("references")}`;
+  return {
+    message: `${code(`cite: "${id}"`)} names a reference that does not exist.`,
+    next: chooseNext(id, ids, add)
+  };
+};
+var citeUnsupportedLocation = (finding2) => {
+  const where = match(finding2.message, /^cite and footnote are not supported in ([^;]+);/)?.[1];
+  const inReferences = /^reference text cannot cite/.test(finding2.message);
+  if (inReferences)
+    return { message: `${code("cite")} and ${code("footnote")} can't be used inside the text of a reference.`, next: `remove ${code("cite")} and ${code("footnote")} from that run.` };
+  return {
+    message: `${code("cite")} and ${code("footnote")} are drawn only in titles, text, bullets, list items and quotes${where ? `, not in ${where}` : ""}.`,
+    next: "move the cited run into a text block, or remove the citation here."
+  };
+};
+var captionUnsupportedPayload = (finding2) => {
+  const type = text(params(finding2).type) ?? match(finding2.message, /; this payload is '(.+?)'/)?.[1];
+  const kind = type ?? (/a group cannot carry one/.test(finding2.message) ? "group" : void 0);
+  const is = kind ? kindPhrase(kind) : "not one of those";
+  return {
+    message: `A ${code("caption")} belongs to one image, chart, table or video; this block is ${is}.`,
+    next: `put the ${code("caption")} on the image, chart, table or video it describes, or remove it.`
+  };
+};
+var imageOptionUnsupportedPayload = (finding2) => {
+  const field = text(params(finding2).field) ?? match(finding2.message, /^(\w+) is only valid on an image payload/)?.[1];
+  const type = text(params(finding2).type) ?? match(finding2.message, /; this payload is '(.+?)'/)?.[1];
+  const kind = type ?? (/a group cannot carry them/.test(finding2.message) ? "group" : void 0);
+  if (!field) return void 0;
+  return {
+    message: `${code(field)} only applies to pictures; this block is ${kind ? kindPhrase(kind) : "not a picture"}.`,
+    next: `remove ${code(field)}, or move it onto an image.`
+  };
+};
+var imagePlacementInvalid = (finding2) => {
+  const { edge, blocks } = params(finding2);
+  if (typeof edge === "string" && Array.isArray(blocks) && blocks.length === 2) {
+    return {
+      message: `Blocks ${Number(blocks[0]) + 1} and ${Number(blocks[1]) + 1} are both placed on the ${edge} edge, and a slide edge takes one placed image.`,
+      next: `move one of them to another edge, or remove its ${code("placement")}.`
+    };
+  }
+  return {
+    message: `${code("placement")} can't be used here: a block inside a group or a region can't bleed to a slide edge.`,
+    next: `use ${code("placement")} on a top-level block of the slide, one per slide edge, or remove it.`
+  };
+};
+var layoutPlaceholderGroup = (finding2) => {
+  const detail = finding2.message.trim();
+  return {
+    message: detail ? `${cap(keep(detail))} A group holds body regions only, not headings.` : "A placeholder group nests at most three levels and holds body regions only, not headings.",
+    next: "flatten the group, and keep the title, subtitle and tag at the layout's top level."
+  };
+};
+function datasetOf(helpers) {
+  const at2 = helpers.segments.findIndex((segment) => segment === "fields" || segment === "columns" || segment === "mapping" || segment === "highlight");
+  const parent = at2 > 0 ? helpers.segments.slice(0, at2) : helpers.segments.slice(0, -1);
+  for (const candidate of [parent, [...parent, "data"]]) {
+    const value = helpers.valueAt([...candidate, "dataset"]);
+    if (isText2(value)) return value;
+  }
+  return void 0;
+}
+var datasetUnknown = (finding2, _context, helpers) => {
+  const id = unquote(match(finding2.message, /^unknown dataset '(.+?)'/)?.[1]) || String(helpers.valueAt(helpers.segments) ?? "");
+  if (!id) return void 0;
+  const ids = keysAt(helpers, ["datasets"]);
+  const here = ids.length ? `Datasets in this deck: ${plainList(ids)}.` : "This deck has no datasets.";
+  return {
+    message: `${code(`dataset: "${id}"`)} does not exist. ${here}`,
+    next: chooseNext(id, ids, `add ${code(`datasets.${id}`)}`)
+  };
+};
+var datasetFieldUnknown = (finding2, _context, helpers) => {
+  const found = match(finding2.message, /^field ("(?:[^"\\]|\\.)*") is not a column of the dataset; use one of (.+)$/);
+  if (!found) return void 0;
+  const field = unquote(found[1]);
+  const columns = unquoteList(found[2]);
+  const dataset = datasetOf(helpers);
+  return {
+    message: `${code(field)} is not a column of ${dataset ? code(dataset) : "the dataset"}. Columns: ${plainList(columns)}.`,
+    next: chooseNext(field, columns)
+  };
+};
+var dataColumnDuplicate = (finding2, _context, helpers) => {
+  const name = unquote(match(finding2.message, /^column name ("(?:[^"\\]|\\.)*") is used by an earlier column/)?.[1]);
+  if (!name) return void 0;
+  const columns = helpers.valueAt(helpers.segments.slice(0, -1));
+  const taken = Array.isArray(columns) ? columns.map((entry2) => isRecord2(entry2) ? String(entry2.name) : String(entry2)) : [];
+  return {
+    message: `Two columns are named ${code(name)}. Series and mappings address columns by name.`,
+    next: `rename the second one (for example ${code(freshName(name, taken))}).`
+  };
+};
+var chartMappingUnknownColumn = (finding2) => {
+  const found = match(finding2.message, /^mapping names column ("(?:[^"\\]|\\.)*"), which the chart data does not have; use one of (.+)$/);
+  if (!found) return void 0;
+  const name = unquote(found[1]);
+  const columns = unquoteList(found[2]);
+  return {
+    message: `The chart mapping names column ${code(name)}, which the data does not have. Columns: ${plainList(columns)}.`,
+    next: chooseNext(name, columns)
+  };
+};
+var numberFormatInvalid = (finding2, _context, helpers) => {
+  const value = helpers.valueAt(helpers.segments);
+  const reason = match(finding2.message, /^Number format '.*?' ((?:needs|scales|has|uses|asks|allows|is)\b.+)$/)?.[1];
+  const subject = typeof value === "string" && value ? `${code(value)} is not a number format OPF can read` : "This is not a number format OPF can read";
+  return {
+    message: `${subject}.${reason ? ` It ${sentence(us(reason))}` : ""}`,
+    next: `write a format such as ${code("0.0")}, ${code("#,##0")}, ${code("0%")} or ${code("$#,##0.00")}.`
+  };
+};
+var chartHighlightUnknownName = (finding2) => {
+  const series = match(finding2.message, /^highlight names series ("(?:[^"\\]|\\.)*"), which the chart data does not have as a column; use one of (.+)$/);
+  if (series) {
+    const name = unquote(series[1]);
+    const columns = unquoteList(series[2]);
+    return { message: `${code(`highlight: "${name}"`)} matches no series. Available: ${plainList(columns)}.`, next: chooseNext(name, columns) };
+  }
+  const category = match(finding2.message, /^highlight names category ("(?:[^"\\]|\\.)*"), which no row of the chart data has as its label(?:; the labels are (.+))?$/);
+  if (category) {
+    const name = unquote(category[1]);
+    const labels = unquoteList(category[2]);
+    return {
+      message: `${code(`highlight: "${name}"`)} matches no category.${labels.length ? ` Available: ${plainList(labels)}${/\.\.\.$/.test(category[2] ?? "") ? ", \u2026" : ""}.` : ""}`,
+      next: labels.length ? chooseNext(name, labels) : "name a category that appears in the chart data, or remove the entry."
+    };
+  }
+  return void 0;
+};
+var tokenOf = (finding2, id) => finding2.message.includes(`var:${id}`) ? code(`var:${id}`) : code(`{{${id}}}`);
+var SAMPLE_BY_KIND = {
+  number: "a plain number such as 42",
+  date: "a date such as 2026-10-24",
+  color: "a color such as #1F4E79",
+  url: "a web address such as https://example.com",
+  image: "an `asset:` reference or an https:// address",
+  list: "a list of values",
+  text: "some text"
+};
+var variableInvalidValue = (finding2) => {
+  const found = match(finding2.message, /^Value for '(.+?)' \((\w+)\): (.+?)\.?$/);
+  const id = text(params(finding2).id) ?? found?.[1];
+  if (!id) return void 0;
+  const kind = found?.[2] ?? "";
+  return {
+    message: `The value given for ${code(id)} does not fit its type${kind ? ` (${kind})` : ""}${found?.[3] ? `: ${us(found[3])}` : ""}.`,
+    next: `give it ${SAMPLE_BY_KIND[kind] ?? "a value of the declared type"}.`
+  };
+};
+var BUILTINS = ["deck.name", "deck.description", "deck.author", "deck.slideCount", "slide.number", "slide.section", "speakers", "speaker.name", "speaker.title", "speaker.email", "speaker.phone", "speaker.bio", "speaker.photo", "organization.name", "organization.legalName", "organization.tagline", "organization.domain", "organization.email", "organization.phone"];
+var variableUnknownBuiltin = (finding2) => {
+  const id = text(params(finding2).id) ?? match(finding2.message, /^'(.+?)' is not a built-in variable/)?.[1];
+  if (!id) return void 0;
+  const mentioned = [...finding2.message.matchAll(/'((?:deck|slide|speaker|organization)[A-Za-z0-9_.-]*|speakers)'/g)].map((entry2) => entry2[1]).filter((name) => name !== id);
+  const candidates = [.../* @__PURE__ */ new Set([...mentioned, ...BUILTINS])];
+  const { close } = nearest(id, candidates);
+  const whole = /^'var:/.test(finding2.message) || finding2.message.includes(`'var:${id}'`);
+  const message = whole ? `${code(`var:${id}`)} is not supported: ${code(id)} is a slide-scoped built-in, written only as the inline token ${code(`{{${id}}}`)}.` : `${tokenOf(finding2, id)} is not a built-in variable.`;
+  if (whole) return { message, next: `write ${code(`{{${id}}}`)} inside the text instead.` };
+  return { message, next: close.length ? `did you mean ${code(close[0])}?` : `use one of ${codeList(mentioned.length ? mentioned : BUILTINS.slice(0, 4), 4, "or")}, or declare ${code(id)} under ${code("variables")}.` };
+};
+var variableFormat = (finding2, _context, helpers) => {
+  const id = text(params(finding2).id);
+  const declared = id ? helpers.valueAt(["variables", id, "format"]) : void 0;
+  const reason = match(finding2.message, /^(?:Number|Date) format '.*?' (.+)$/)?.[1];
+  const kind = id ? helpers.valueAt(["variables", id, "type"]) : void 0;
+  return {
+    message: `The format${typeof declared === "string" ? ` ${code(declared)}` : ""} does not apply to ${kind ? `a ${String(kind)}` : "this"} value${id ? ` (${code(id)})` : ""}${reason ? `: it ${sentence(us(reason)).replace(/\.$/, "")}` : ""}.`,
+    next: `change the ${code("format")} of ${id ? code(id) : "the variable"} to one that fits its values, such as ${kind === "date" ? code("MMMM d, yyyy") : code("#,##0.0")}.`
+  };
+};
+var variableUnfilled = (finding2, _context, helpers) => {
+  const token = match(finding2.message, /^Template variable ("\{\{.+\}\}") is still in the text\.$/);
+  if (token) {
+    const literal = unquote(token[1]);
+    const id2 = /\{\{\s*([a-z][a-z0-9-]*)/.exec(literal)?.[1] ?? literal;
+    return {
+      message: `${code(literal)} is still in the text, so it would show literally.`,
+      next: `declare ${code(id2)} under ${code("variables")} and give it a value, or replace the token with the real text.`
+    };
+  }
+  const id = text(params(finding2).id) ?? match(finding2.message, /^(?:required variable '(.+?)'|Template variable ("(?:[^"\\]|\\.)*")) has no value/)?.[1] ?? helpers.segments.at(-1);
+  const inTemplate = /^Template variable/.test(finding2.message);
+  if (!id) return void 0;
+  const name = id.startsWith('"') ? unquote(id) : id;
+  if (inTemplate) {
+    return {
+      message: `Template variable ${code(name)} has no value yet.`,
+      next: `fill it (${code("opf fill")}) before using the deck, or leave it while you edit the template.`
+    };
+  }
+  return {
+    message: `Required variable ${code(name)} has no value, so ${code(`{{${name}}}`)} would show literally.`,
+    next: `give it a ${code("value")}, or mark the deck ${code("template: true")}.`
+  };
+};
+var variableUnknown = (finding2, _context, helpers) => {
+  const id = text(params(finding2).id) ?? match(finding2.message, /^'\{\{(.+?)\}\}' names no declared variable/)?.[1];
+  if (!id) return void 0;
+  const declared = keysAt(helpers, ["variables"]);
+  const { close } = nearest(id, declared);
+  return {
+    message: `${code(`{{${id}}}`)} is not declared under ${code("variables")}.`,
+    next: close.length ? `did you mean ${code(close[0])}? Or declare ${code(id)} under ${code("variables")}.` : `declare ${code(id)} under ${code("variables")}, or write ${code("\\{{")} for literal braces.`
+  };
+};
+var variableUnknownValue = (finding2, _context, helpers) => {
+  const id = text(params(finding2).id) ?? match(finding2.message, /^A value was supplied for '(.+?)'/)?.[1];
+  if (!id) return void 0;
+  const declared = keysAt(helpers, ["variables"]);
+  const { close } = nearest(id, declared);
+  return {
+    message: `A value was supplied for ${code(id)}, which is not declared.`,
+    next: close.length ? `did you mean ${code(close[0])}? Or declare ${code(id)} under ${code("variables")}.` : `declare ${code(id)} under ${code("variables")}, or remove the value.`
+  };
+};
+var variableUnused = (finding2, _context, helpers) => {
+  const id = text(params(finding2).id) ?? helpers.segments.at(-1);
+  if (!id) return void 0;
+  return {
+    message: `Variable ${code(id)} is declared but never used.`,
+    next: `use it as ${code(`{{${id}}}`)} or ${code(`var:${id}`)} where it belongs, or remove its declaration.`
+  };
+};
+var variableReferenceUnknown = (finding2, _context, helpers) => {
+  const id = text(params(finding2).id) ?? match(finding2.message, /^unknown variable '(.+?)'/)?.[1];
+  if (!id) return void 0;
+  const declared = keysAt(helpers, ["variables"]);
+  const { close } = nearest(id, declared);
+  return {
+    message: `${code(`var:${id}`)} is not declared, so a default color is used.`,
+    next: close.length ? `did you mean ${code(`var:${close[0]}`)}? Or declare ${code(id)} under ${code("variables")}.` : `declare ${code(id)} under ${code("variables")}, or use another color.`
+  };
+};
+var SCHEME_COLORS = ["accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "dark1", "dark2", "light1", "light2", "hyperlink", "followedHyperlink", "primary", "secondary", "accent", "background", "surface", "surfaceAlt", "text", "textSecondary"];
+var runColorUnrecognized = (finding2, _context, helpers) => {
+  const value = text(params(finding2).color) ?? match(finding2.message, /^run color '(.+?)' is not/)?.[1] ?? text(helpers.valueAt(helpers.segments));
+  if (!value) return void 0;
+  const { close } = nearest(value, SCHEME_COLORS);
+  return {
+    message: `${code(`color: "${value}"`)} is not a hex color, a scheme color or a ${code("var:")} reference, so the theme color is used.`,
+    next: close.length ? `did you mean ${code(close[0])}?` : `write a hex color like ${code("#1F4E79")}, a scheme color such as ${code("accent1")}, or ${code("var:")} and a variable id.`
+  };
+};
+var numberingStartIgnored = (_finding, _context, helpers) => {
+  const owner = lastName(helpers.segments);
+  return {
+    message: `${code("start")} has no effect without ${code("numbering")} on ${owner ? `the ${code(owner)} list` : "this list"}.`,
+    next: `add ${code("numbering")} to the list, or remove ${code("start")}.`
+  };
+};
+var slideSizeOutOfRange = (finding2) => {
+  const { widthInches, heightInches } = params(finding2);
+  const size = typeof widthInches === "number" && typeof heightInches === "number" ? `A ${widthInches}\xD7${heightInches} in slide` : "This slide size";
+  return {
+    message: `${size} is outside PowerPoint's 1 to 56 inch range, so PowerPoint may reject the export.`,
+    next: `set ${code("design.dimensions")} to sizes between 1 and 56 inches, or to a preset.`
+  };
+};
+var undeclaredCatalog = (finding2) => {
+  const found = match(finding2.message, /^Reference ("(?:[^"\\]|\\.)*") names catalog group ("(?:[^"\\]|\\.)*"), which/);
+  if (!found) return void 0;
+  const reference = unquote(found[1]);
+  const group = unquote(found[2]);
+  const bare = reference.includes(":") ? reference.slice(reference.indexOf(":") + 1) : reference;
+  return {
+    message: `${code(reference)} uses catalog group ${code(group)}, which ${code("catalogs")} does not declare, so it can never resolve.`,
+    next: `declare ${code(`catalogs.${group}`)}, or write ${code(bare)}.`
+  };
+};
+var assetReference = (finding2, _context, helpers) => {
+  const id = unquote(match(finding2.message, /^Asset ("(?:[^"\\]|\\.)*") is missing/)?.[1]);
+  if (!id) return void 0;
+  const ids = keysAt(helpers, ["assets"]);
+  const suggested = (finding2.suggestions ?? []).map((entry2) => String(entry2.value).replace(/^asset:/, ""));
+  const known = ids.length ? ids : suggested;
+  const { close } = nearest(id, known);
+  const add = `add ${code(`assets.${id}`)}`;
+  return {
+    message: `${code(`asset:${id}`)} is not in ${code("assets")}.${known.length ? ` Assets: ${plainList(known)}.` : " This deck has no assets."}`,
+    next: close.length ? `did you mean ${code(`asset:${close[0]}`)}? Or ${add}.` : known.length ? `pick one of ${plainList(known.slice(0, 4))}, or ${add}.` : `${add}.`
+  };
+};
+var assetCycle = (finding2) => {
+  const chainText = match(finding2.message, /^Asset references form a cycle: (.+)\.$/)?.[1];
+  const chain = chainText ? chainText.split(" \u2192 ").map(unquote) : [];
+  const first = chain[0];
+  if (!first || chain.length < 2) return void 0;
+  const through = chain.slice(1, -1);
+  const how = through.length ? ` through ${codeList(through)}` : "";
+  return {
+    message: `Asset ${code(first)} points back to itself${how}.`,
+    next: "give one link a real source (an https:// address or embedded data) instead of an `asset:` reference."
+  };
+};
+var KIND_SINGULAR = (kind) => KIND_WORDS[kind] ?? kind.replace(/s$/, "");
+var catalogRecord = (finding2, context) => {
+  const [root, group, kind, id] = finding2.path.split("/").slice(1).map((part) => part.replaceAll("~1", "/").replaceAll("~0", "~"));
+  if (root !== "catalogs" || !kind || !id) return void 0;
+  const inner = describeFinding({ ...finding2, ruleId: "opf/schema" }, context);
+  const registered = finding2.scope === "context";
+  const record = `${registered ? "The registered" : "The embedded"} ${KIND_SINGULAR(kind)} ${code(id)}`;
+  return {
+    message: `${record} is invalid: ${inner.message.charAt(0).toLowerCase()}${inner.message.slice(1)}`,
+    next: inner.next ?? `fix the record; references to it are reported too.`
+  };
+};
+function layoutSpot(finding2) {
+  const parts2 = finding2.path.split("/").slice(1).map((part) => part.replaceAll("~1", "/").replaceAll("~0", "~"));
+  if (parts2[0] === "catalogs" && parts2[2] === "layouts") return { id: parts2[3], spot: dotted(parts2.slice(4)) };
+  return { spot: dotted(parts2) };
+}
+var layoutTemplate = (finding2) => {
+  const { id, spot } = layoutSpot(finding2);
+  const detail = finding2.message.trim().replace(/\.$/, "");
+  return {
+    message: `The layout's region list is malformed${spot ? ` at ${code(spot)}` : ""}${id ? ` (layout ${code(id)})` : ""}: ${us(detail)}.`,
+    next: spot ? `correct ${code(spot)} as described; the layout is not used until it is valid.` : "correct the layout as described; it is not used until it is valid."
+  };
+};
+var layoutRegion = (finding2) => {
+  const { id, spot } = layoutSpot(finding2);
+  const detail = finding2.message.trim().replace(/\.$/, "");
+  const reserved = match(detail, /^'(.+?)' is reserved and cannot name a body region \(reserved: (.+)\)$/);
+  if (reserved) {
+    return {
+      message: `Region name ${code(reserved[1])} is reserved, so it can't name a body region${id ? ` of layout ${code(id)}` : ""}. Reserved names: ${reserved[2]}.`,
+      next: `rename it, for example ${code(`${reserved[1]}-area`)}.`
+    };
+  }
+  const twice = match(detail, /^region name '(.+?)' is used twice/);
+  if (twice) {
+    return {
+      message: `Region name ${code(twice[1])} is used twice; names are unique across the whole layout.`,
+      next: `rename one of them (for example ${code(freshName(twice[1]))}).`
+    };
+  }
+  const badName = match(detail, /^'(.+?)' is not a region name/);
+  if (badName) {
+    const bad = badName[1];
+    return {
+      message: `${code(bad)} is not a valid region name: use lowercase letters, digits and hyphens, starting with a letter.`,
+      next: `rename it, for example ${code(bad.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^[^a-z]+|-+$/g, "") || "body")}.`
+    };
+  }
+  return {
+    message: `A region of the layout is not valid${spot ? ` at ${code(spot)}` : ""}${id ? ` (layout ${code(id)})` : ""}: ${us(detail)}.`,
+    next: spot ? `correct ${code(spot)} as described.` : "correct the layout as described."
+  };
+};
+var FALLBACK = (kind) => kind === "layouts" ? "the slide is laid out automatically" : "the engine default is used";
+var unresolvedReference2 = (finding2, _context, helpers) => {
+  const found = match(finding2.message, /^([A-Z][A-Za-z ]*?) '(.+?)' resolves nowhere/);
+  const kind = finding2.lookup?.[2] ?? "";
+  const reference = found?.[2] ?? (() => {
+    const value = helpers.valueAt(helpers.segments);
+    return typeof value === "string" ? value : void 0;
+  })();
+  if (!reference) return void 0;
+  const noun = cap(KIND_SINGULAR(kind || (found?.[1] ?? "catalog record").toLowerCase()));
+  const colon = reference.indexOf(":");
+  const group = colon > 0 ? reference.slice(0, colon) : void 0;
+  const bare = colon > 0 ? reference.slice(colon + 1) : reference;
+  const embeddedIn = group ? [group] : ["custom", "default"];
+  const embedded = kind && embeddedIn.some((name) => isRecord2(helpers.valueAt(["catalogs", name, kind, bare])));
+  const suggestions = (finding2.suggestions ?? []).slice(0, 5).map((entry2) => String(entry2.value));
+  if (embedded) {
+    return {
+      message: `${noun} ${code(reference)} is embedded but invalid, so it is not used and ${FALLBACK(kind)}.`,
+      next: `fix the record named in the other problems, or remove the reference.`
+    };
+  }
+  const message = group && /declares no catalogs\./.test(finding2.message) ? `${noun} ${code(reference)} uses catalog group ${code(group)}, which the deck does not declare, so ${FALLBACK(kind)}.` : `${noun} ${code(reference)} is not embedded or in a registered catalog, so ${FALLBACK(kind)}.`;
+  const { close } = nearest(reference, suggestions);
+  const remove = kind === "layouts" ? "remove the reference to let OPF pick" : "remove the reference";
+  return {
+    message,
+    next: close.length ? `did you mean ${code(close[0])}?` : suggestions.length ? `choose one of ${codeList(suggestions, 5, "or")}, embed the record under ${code("catalogs.custom")}, or ${remove}.` : `embed the record under ${code("catalogs.custom")}, register the catalog that defines it, or ${remove}.`
+  };
+};
+var catalogRecordNotInSource = (finding2) => {
+  const found = match(finding2.message, /^Record ("(?:[^"\\]|\\.)*") is embedded under catalogs\.([^.]+)\.(\w+), but the catalog registered for (.+?) has no /);
+  if (!found) return void 0;
+  const id = unquote(found[1]);
+  const group = found[2];
+  return {
+    message: `${code(id)} says it comes from ${found[4]}, but that catalog has no such record. It is treated as your own.`,
+    next: `move it to ${code("catalogs.custom")}${group === "default" ? "" : ` and drop the ${code(`${group}:`)} prefix from its references`}, or use an id that the catalog publishes.`
+  };
+};
+var unusedReference = (finding2, _context, helpers) => {
+  const id = text(params(finding2).id) ?? match(finding2.message, /^reference '(.+?)' is never cited/)?.[1];
+  if (!id) return void 0;
+  return {
+    message: `Reference ${code(id)} is never cited.`,
+    next: `cite it from a text, bullet or list item (${code(`cite: "${id}"`)}), or remove it.`
+  };
+};
+var unusedDataset = (finding2, _context, helpers) => {
+  const id = helpers.segments.at(-1) ?? unquote(match(finding2.message, /^Dataset ("(?:[^"\\]|\\.)*") is never referenced/)?.[1]);
+  if (!id) return void 0;
+  return {
+    message: `Dataset ${code(id)} is not used by any chart or table.`,
+    next: `point a chart or table at it with ${code(`dataset: "${id}"`)}, or remove it.`
+  };
+};
+var unknownBeat = (finding2, _context, helpers) => {
+  const found = match(finding2.message, /^Slide (\d+) names beat ("(?:[^"\\]|\\.)*"), which narrative ("(?:[^"\\]|\\.)*") does not define/);
+  if (!found) return void 0;
+  const beat = unquote(found[2]);
+  const narrative = unquote(found[3]);
+  const beats = (finding2.suggestions ?? []).map((entry2) => String(entry2.value));
+  const { close } = nearest(beat, beats);
+  return {
+    message: `Slide ${found[1]} names beat ${code(beat)}, which narrative ${code(narrative)} does not define.${beats.length ? ` Its beats include ${plainList(beats.slice(0, 5))}.` : ""}`,
+    next: close.length ? `did you mean ${code(close[0])}?` : beats.length ? `use one of ${codeList(beats, 5, "or")}, or remove ${code("beat")}.` : `use a beat the narrative defines, or remove ${code("beat")}.`
+  };
+};
+var slideThemeDimensions = (finding2) => {
+  const { slideDimensions, deckDimensions } = params(finding2);
+  const nice = (value) => {
+    const found = /^([\d.]+)x([\d.]+) px$/.exec(String(value ?? ""));
+    return found ? `${Math.round(Number(found[1]))}\xD7${Math.round(Number(found[2]))} px` : void 0;
+  };
+  const slide = nice(slideDimensions);
+  const deck = nice(deckDimensions);
+  return {
+    message: `This slide's theme sets another slide size${slide && deck ? ` (${slide}; the deck is ${deck})` : ""}, which is ignored: a deck has one size.`,
+    next: `set ${code("design.dimensions")} on the deck, or give every slide's theme the same dimensions.`
+  };
+};
+var contract = (finding2, _context, helpers) => {
+  const actual = helpers.valueAt(helpers.segments);
+  const allowed = (finding2.suggestions ?? []).filter((entry2) => entry2.origin === "contract").map((entry2) => entry2.value);
+  const standard = match(finding2.message, /^This value is outside the allowed values for (.+)\.$/);
+  const label = helpers.segments.length ? fieldLabel(helpers.segments) : "the deck";
+  const allowedWords = allowed.length ? plainList(allowed.map((value) => typeof value === "string" ? value : JSON.stringify(value)), 6) : void 0;
+  const message = standard ? `${cap(label)} is ${actual === void 0 ? "missing or unset" : describeValue(actual)}, which this host's policy does not allow.${allowedWords ? ` Allowed: ${allowedWords}.` : ""}` : keep(finding2.message);
+  return {
+    message,
+    next: allowed.length ? chooseNext(actual, allowed.map((value) => typeof value === "string" ? value : JSON.stringify(value))) : helpAsNext(finding2, "change it to an allowed value.")
+  };
+};
+var FORMAT_TEXT = {
+  "opf/json-syntax": jsonSyntax,
+  "opf/duplicate-key": duplicateKey,
+  "opf/schema": schemaPlain,
+  "opf/reference-id-duplicate": referenceIdDuplicate,
+  "opf/cite-unknown-reference": citeUnknownReference,
+  "opf/cite-unsupported-location": citeUnsupportedLocation,
+  "opf/caption-unsupported-payload": captionUnsupportedPayload,
+  "opf/image-option-unsupported-payload": imageOptionUnsupportedPayload,
+  "opf/image-placement-invalid": imagePlacementInvalid,
+  "opf/layout-placeholder-group": layoutPlaceholderGroup,
+  "opf/dataset-unknown": datasetUnknown,
+  "opf/dataset-field-unknown": datasetFieldUnknown,
+  "opf/data-column-duplicate": dataColumnDuplicate,
+  "opf/chart-mapping-unknown-column": chartMappingUnknownColumn,
+  "opf/number-format-invalid": numberFormatInvalid,
+  "opf/variable-invalid-value": variableInvalidValue,
+  "opf/variable-unknown-builtin": variableUnknownBuiltin,
+  "opf/chart-highlight-unknown-name": chartHighlightUnknownName,
+  "opf/variable-format": variableFormat,
+  "opf/variable-unfilled": variableUnfilled,
+  "opf/run-color-unrecognized": runColorUnrecognized,
+  "opf/numbering-start-ignored": numberingStartIgnored,
+  "opf/slide-size-out-of-range": slideSizeOutOfRange,
+  "opf/undeclared-catalog": undeclaredCatalog,
+  "opf/asset-reference": assetReference,
+  "opf/asset-cycle": assetCycle,
+  "opf/catalog-record": catalogRecord,
+  "opf/layout-template": layoutTemplate,
+  "opf/layout-region": layoutRegion,
+  "opf/unresolved-reference": unresolvedReference2,
+  "opf/catalog-record-not-in-source": catalogRecordNotInSource,
+  "opf/unused-reference": unusedReference,
+  "opf/unused-dataset": unusedDataset,
+  "opf/unknown-beat": unknownBeat,
+  "opf/slide-theme-dimensions": slideThemeDimensions,
+  "opf/variable-unknown": variableUnknown,
+  "opf/variable-unknown-value": variableUnknownValue,
+  "opf/variable-unused": variableUnused,
+  "opf/variable-reference-unknown": variableReferenceUnknown,
+  "opf/contract": contract
+};
+
+// src/finding-text-rules.ts
+var GENERIC_NEXT = "check the rule's documentation for how to fix it.";
+function safe(handler) {
+  return (finding2, context, helpers) => {
+    try {
+      const text2 = handler(finding2, context, helpers);
+      if (text2?.message && text2.next) return text2;
+    } catch {
+    }
+    return { message: keep(finding2.message || "This finding has no message"), next: helpAsNext(finding2, GENERIC_NEXT) };
+  };
+}
+var RULE_TEXT = Object.freeze(
+  Object.fromEntries(Object.entries({ ...FORMAT_TEXT, ...AUDIT_TEXT }).map(([id, handler]) => [id, safe(handler)]))
+);
+
+// src/markdown/dialect.ts
+var SLIDE_OPTION_KEYS = ["id", "type", "layout", "section", "tag", "hidden", "beat"];
+var BLOCK_OPTION_KEYS = ["id", "type", "as", "region"];
+var BLOCK_AS_VALUES = ["bullets", "video"];
+var FENCE_KINDS = ["chart", "metric", "timeline", "opf-block", "opf-slide"];
+var METRIC_KEYS = ["value", "label", "description", "unit", "delta", "trend", "sentiment"];
+var FENCE_ATTRIBUTES = { chart: ["alt"], timeline: ["name", "description"], code: ["title"] };
+var SPAN_FLAGS = ["bold", "italic", "underline", "strike", "sup", "sub"];
+var SPAN_VALUES = ["color", "size", "font", "lang"];
+var LINE_KEYWORDS = ["Note:", "Notes:"];
+
+// src/finding-text-source.ts
+var keep2 = (finding2, next) => next ? { message: finding2.message, next } : { message: finding2.message };
+var wholeHelp = (finding2) => keep2(finding2, finding2.help ? asNext(finding2.help) : void 0);
+var line = (finding2) => finding2.location?.line ?? 1;
+var quoted = (text2, pattern) => pattern.exec(text2)?.[1];
+var optionKeys = (kind) => kind === "block" ? BLOCK_OPTION_KEYS : SLIDE_OPTION_KEYS;
+var options = {
+  "markdown/options-unknown-key": (finding2) => {
+    const kind = quoted(finding2.message, /^Unknown (slide|block) option/) ?? "slide";
+    const key2 = quoted(finding2.message, /option "(.*)"\.$/) ?? "";
+    const guess = finding2.suggestions?.[0]?.value;
+    const keys = optionKeys(kind).join(", ");
+    return {
+      message: `${code(key2)} is not a ${kind} option.`,
+      next: guess !== void 0 ? `did you mean ${code(guess)}? The keys are ${keys}. Anything else goes in an \`opf-${kind}\` fence.` : `use one of ${keys}. Anything else goes in an \`opf-${kind}\` fence.`
+    };
+  },
+  "markdown/options-value": (finding2) => {
+    if (/^hidden takes/.test(finding2.message)) return keep2(finding2, "write `hidden=true`, `hidden=false` or just `hidden`.");
+    const key2 = quoted(finding2.message, /^Option (\w+) needs a value/);
+    if (key2) return keep2(finding2, `write ${code(`${key2}=value`)}, for example ${code(key2 === "layout" ? "layout=title" : key2 === "id" ? "id=cover" : `${key2}=name`)}.`);
+    if (/^as takes/.test(finding2.message)) return keep2(finding2, "write `as=bullets` before a list or `as=video` before an image line.");
+    return keep2(finding2, "put `as=bullets` before a list and `as=video` before an image line, or remove `as`.");
+  },
+  "markdown/options-syntax": (finding2) => keep2(finding2, `write options as ${code("key=value")} pairs, with text in double quotes: ${code('<!-- slide: layout=title section="Part 1" -->')}.`),
+  "markdown/options-duplicate": (finding2) => {
+    const key2 = quoted(finding2.message, /^Option (\w+) is given twice/);
+    if (key2) return keep2(finding2, `keep one ${code(`${key2}=`)} in the comment.`);
+    return keep2(finding2, "merge them into one.");
+  },
+  "markdown/options-orphan": (finding2) => keep2(finding2, "put the `<!-- block: \u2026 -->` comment directly before the block it describes, or remove it."),
+  "markdown/options-trailing": (finding2) => keep2(finding2, "put the content on its own line after the options comment."),
+  "markdown/options-embedded": (finding2) => keep2(finding2, "remove the comment and put `id` and `type` inside the `opf-block` YAML.")
+};
+var markdown = {
+  "markdown/front-matter-unterminated": (finding2) => keep2(finding2, "add a line with only `---` after the settings, or remove the opening `---` (a deck without front matter starts with its first slide)."),
+  "markdown/front-matter-slides": () => ({
+    message: "The front matter can't hold `slides`: the slides are the Markdown below it.",
+    next: "remove the `slides` key and write the slides below the front matter, separated by `---`."
+  }),
+  "markdown/front-matter-comments": (finding2) => keep2(finding2, "add the deck properties as `key: value` lines, or remove the first `---` if the file starts with a slide."),
+  "markdown/no-slides": (finding2) => keep2(finding2, "write a `# Title` line, or any content, then `---` between slides."),
+  "markdown/comment-unterminated": (finding2) => ({ message: `The ${code("<!--")} on line ${line(finding2)} has no ${code("-->")}.`, next: "end the comment with `-->`." }),
+  "markdown/fence-unterminated": (finding2) => {
+    const fence = /Add a closing (`{3,}|~{3,}) line/.exec(finding2.help ?? "")?.[1] ?? "```";
+    return { message: `The ${fence} fence opened on line ${line(finding2)} is never closed.`, next: `add a line with ${fence} to close it.` };
+  },
+  "markdown/code-fence": (finding2) => ({ message: `The code fence opened on line ${line(finding2)} could not be read as code.`, next: "close the fence with at least as many backticks as opened it." }),
+  "markdown/chart-type": () => ({ message: "A chart fence needs its type after `chart`.", next: "write ```chart column (also `bar`, `line`, `pie`, \u2026), then the data." }),
+  "markdown/chart-attributes": (finding2) => keep2(finding2, 'write ```chart column alt="What the data shows" (`alt` is optional).'),
+  "markdown/chart-data": wholeHelp,
+  "markdown/chart-ragged": (finding2) => keep2(finding2, "give every row one value per column."),
+  "markdown/metric-block": (finding2) => keep2(finding2, `write ${code("key: value")} lines using ${METRIC_KEYS.join(", ")}; a value is plain text or a JSON string in double quotes.`),
+  "markdown/timeline-attributes": (finding2) => keep2(finding2, 'write ```timeline name="Roadmap" description="\u2026" (both are optional).'),
+  "markdown/timeline-description": (finding2) => keep2(finding2, "put the event first, then its description indented below it."),
+  "markdown/timeline-events": (finding2) => keep2(finding2, "write one event per line, for example `2024 Q1 \u2014 Pilot`."),
+  "markdown/slide-property-conflict": (finding2) => {
+    const field = quoted(finding2.message, /property "(.*)" is set twice/) ?? finding2.path.split("/").at(-1) ?? "field";
+    return { message: `${code(field)} is set both in the Markdown and in the \`opf-slide\` fence.`, next: "keep it in one of the two places." };
+  },
+  "markdown/duplicate-title": (finding2) => keep2(finding2, "use `---` to start a new slide, or `##` for the subtitle."),
+  "markdown/duplicate-subtitle": (finding2) => keep2(finding2, "write further lines as paragraphs; a slide has one subtitle."),
+  "markdown/empty-heading": (finding2) => keep2(finding2, "write the title after the `#`, or remove the line."),
+  "markdown/empty-quote": (finding2) => keep2(finding2, "write the quote after `>`."),
+  "markdown/image-source": (finding2) => keep2(finding2, "write the file or address inside the parentheses: `![alt](path.png)`."),
+  "markdown/heading-demoted": (finding2) => keep2(finding2, "use `#` for the title and `##` for the subtitle; a bold paragraph on purpose silences this."),
+  "markdown/empty-slide": (finding2) => keep2(finding2, "remove the extra `---`, or write `<!-- slide -->` to keep an empty slide."),
+  "markdown/numbered-list": () => ({
+    message: "Numbers in a list aren't kept: the list becomes bullets.",
+    next: "add `numbering` to the slide in an `opf-slide` fence (see docs/numbered-lists.md), write the numbers into the text, or use a bulleted list."
+  }),
+  "markdown/table-ragged": (finding2) => keep2(finding2, "give every row the same number of cells as the header."),
+  "markdown/formatting-dropped": (finding2) => keep2(finding2, "use a plain string here, or put the field in an `opf-slide` fence."),
+  "markdown/front-matter": wholeHelp,
+  "markdown/front-matter-not-mapping": wholeHelp,
+  "markdown/opf-slide": wholeHelp,
+  "markdown/opf-slide-not-mapping": wholeHelp,
+  "markdown/opf-block": wholeHelp,
+  "markdown/opf-block-not-mapping": wholeHelp
+};
+var yaml = Object.fromEntries(
+  ["yaml/syntax", "yaml/empty", "yaml/not-mapping", "yaml/multiple-documents", "yaml/duplicate-key", "yaml/key", "yaml/tag", "yaml/number", "yaml/alias", "yaml/alias-limit", "yaml/alias-cycle"].map((id) => [id, wholeHelp])
+);
+var SOURCE_TEXT = { ...yaml, ...markdown, ...options };
+var entry = (category, severity, summary, rationale, fix, problem, fixed, language = "markdown") => ({
+  category,
+  severity,
+  summary,
+  rationale,
+  fix,
+  ...problem !== void 0 && fixed !== void 0 ? { example: { problem, fixed, language } } : {}
+});
+var YAML_WHY = "OPF reads JSON-compatible YAML 1.2, so a file that is not valid YAML cannot be opened at all; the finding says where the reader gave up.";
+var SOURCE_EXPLAIN = {
+  "yaml/syntax": entry("format", "error", "The YAML text cannot be parsed.", YAML_WHY, "Fix the line the message names: indent with spaces, close quotes and brackets, give every key a colon and a value.", "slides:\n	- title: a", "slides:\n  - title: a", "yaml"),
+  "yaml/empty": entry("format", "error", "The YAML document is empty.", "An empty file (or one that is all comments) holds no deck.", "Write `slides:` and at least one `- title:` line.", "# deck", "slides:\n  - title: Title", "yaml"),
+  "yaml/not-mapping": entry("format", "error", "The top level of the YAML is not a mapping.", "A deck is a mapping of properties (`name`, `slides`, ...); a bare list or value has nowhere to put them.", "Start with `key: value` lines, and put a list of slides under `slides:`.", "- title: a", "slides:\n  - title: a", "yaml"),
+  "yaml/multiple-documents": entry("format", "error", "The file holds more than one YAML document.", "An OPF file is exactly one document; a second `---` starts a document the reader would silently ignore.", "Remove the extra `---`, or put each deck in its own file.", "a: 1\n---\nb: 2", "a: 1\nb: 2", "yaml"),
+  "yaml/duplicate-key": entry("format", "error", "A YAML mapping repeats a key.", "Parsers keep one value of a repeated key and drop the other, so an author loses content without a trace.", "Keep one of the two, or rename the one you meant as another key.", "name: A\nname: B", "name: B", "yaml"),
+  "yaml/key": entry("format", "error", "A YAML mapping key is not a string.", "JSON keys are always strings; a number, a list or a null as a key cannot be carried.", 'Quote the key: `"1": value`.', "1: x", '"1": x', "yaml"),
+  "yaml/tag": entry("format", "error", "A YAML tag is not allowed.", "OPF reads the YAML core schema; custom tags (`!!binary`, `!!set`) have no JSON form.", "Remove the tag; quote a value to keep it as text.", "a: !!set {x}", "a: x", "yaml"),
+  "yaml/number": entry("format", "error", "A YAML number is not a finite number.", "JSON cannot carry `.inf` or `.nan`.", "Quote the value to keep it as text, or write a finite number.", "n: .inf", 'n: ".inf"', "yaml"),
+  "yaml/alias": entry("format", "error", "A YAML anchor, alias or merge key is not allowed.", "Anchors and aliases make one value stand in for another, which OPF tools do not expand unless asked.", "Write each value out, or read the file with `aliases: true` (CLI: `--aliases`).", "a: &x 1\nb: *x", "a: 1\nb: 1", "yaml"),
+  "yaml/alias-limit": entry("format", "error", "The anchors expand past the limit.", "Aliases that contain aliases grow exponentially; the reader stops at 100.", "Write the repeated values out, or reduce the aliasing.", void 0, void 0, "yaml"),
+  "yaml/alias-cycle": entry("format", "error", "An alias refers to the value that contains it.", "A value that contains itself is infinitely deep and cannot be written as JSON.", "Write the nested value out.", void 0, void 0, "yaml"),
+  "markdown/front-matter-unterminated": entry("format", "error", "The front matter is not closed.", "Without the closing `---` the reader cannot tell where the settings end and the first slide begins.", "Add a line with only `---` after the settings.", "---\nname: x\n\n# A", "---\nname: x\n---\n\n# A"),
+  "markdown/front-matter": entry("format", "error", "The front matter is not valid YAML.", YAML_WHY, "Fix the line the message names.", "---\nname x\n---", "---\nname: x\n---"),
+  "markdown/front-matter-not-mapping": entry("format", "error", "The front matter is not a mapping.", "Front matter holds deck properties as `key: value` lines.", "Write `key: value` lines.", "---\nname x\n---", "---\nname: x\n---"),
+  "markdown/front-matter-slides": entry("format", "error", "The front matter holds `slides`.", "In Markdown the slides are the text below the front matter.", "Remove the `slides` key and write the slides below, separated by `---`.", "---\nslides: []\n---", "---\nname: x\n---"),
+  "markdown/front-matter-comments": entry("format", "warning", "The front matter is only comments.", "A file that opens with `---` then only comments reads as empty front matter, not as slide content.", "Add the deck properties, or remove the first `---`.", void 0, void 0),
+  "markdown/no-slides": entry("format", "error", "The Markdown has no slides.", "A deck needs at least one slide.", "Write a `# Title` line, or any content, then `---` between slides.", "", "# Title"),
+  "markdown/options-syntax": entry("format", "error", "A slide or block options comment is malformed.", "Options are `key=value` pairs; a stray quote or missing value cannot be read.", "Write `<!-- slide: layout=title -->` with values bare or in double quotes.", "<!-- slide: layout= -->", "<!-- slide: layout=title -->"),
+  "markdown/options-unknown-key": entry("format", "error", "An options comment names an option that does not exist.", "The dialect reads a fixed set of keys; an unknown one would be silently lost.", "Use one of the keys, or put other fields in an `opf-slide` fence.", "<!-- slide: layot=cover -->", "<!-- slide: layout=cover -->"),
+  "markdown/options-value": entry("format", "error", "An option has a value it cannot take.", "Each option reads a specific kind of value, for example `hidden` is true or false.", "Write a value the option takes.", "<!-- slide: hidden=maybe -->", "<!-- slide: hidden=true -->"),
+  "markdown/options-duplicate": entry("format", "error", "An option or an options comment is repeated.", "Two comments or two copies of one key leave it unclear which one is meant.", "Merge them into one.", "<!-- slide: layout=a layout=b -->", "<!-- slide: layout=b -->"),
+  "markdown/options-orphan": entry("format", "error", "A block options comment is not followed by a block.", "The comment describes the block right after it.", "Put the comment directly before its block, or remove it."),
+  "markdown/options-trailing": entry("format", "error", "Text follows an options comment on the same line.", "Everything after `-->` on that line would be ignored.", "Put the content on its own line."),
+  "markdown/options-embedded": entry("format", "error", "A block options comment precedes an `opf-block` fence.", "The fence carries its own `id` and `type`.", "Put them inside the fence's YAML."),
+  "markdown/comment-unterminated": entry("format", "error", "An HTML comment is never closed.", "Everything after an unclosed `<!--` would be swallowed into the comment.", "End the comment with `-->`.", "<!-- note", "<!-- note -->"),
+  "markdown/fence-unterminated": entry("format", "error", "A fenced block is never closed.", "Everything after an unclosed fence would be read as its content.", "Add a closing fence line with at least as many backticks as opened it.", "```js\nx", "```js\nx\n```"),
+  "markdown/code-fence": entry("format", "error", "A fenced block could not be read as code.", "A fence closes only with a line of at least as many backticks as opened it.", "Close the fence with at least as many backticks."),
+  "markdown/chart-type": entry("format", "error", "A chart fence has no type.", "A chart needs its type (`column`, `bar`, `line`, `pie`, ...) to be drawn.", "Write the type after `chart`.", "```chart\n```", "```chart column\nCategory,Value\nA,1\n```"),
+  "markdown/chart-attributes": entry("format", "error", "A chart fence has an attribute it cannot take.", "A chart fence takes `alt`, a text alternative in double quotes.", 'Write ```chart column alt="What the data shows".'),
+  "markdown/chart-data": entry("format", "error", "A chart fence has no usable data.", "The chart is drawn from CSV with a header row, or a JSON object with `columns` and `rows`.", "Write CSV with a header row and at least one data row."),
+  "markdown/chart-ragged": entry("format", "warning", "A chart row has a different number of values than the header.", "Missing cells plot as gaps.", "Give every row one value per column."),
+  "markdown/metric-block": entry("format", "error", "A metric fence is malformed.", "A metric is `key: value` lines using a fixed set of keys.", "Write `value:` and, if you like, `label:`, `unit:`, `delta:`, `trend:` and `sentiment:`.", "```metric\nlabel: Revenue\n```", "```metric\nvalue: 42\nlabel: Revenue\n```"),
+  "markdown/timeline-attributes": entry("format", "error", "A timeline fence has an attribute it cannot take.", "A timeline fence takes `name` and `description`.", "Remove the attribute, or use `name=` or `description=`."),
+  "markdown/timeline-description": entry("format", "error", "An indented line has no event above it.", "A description belongs to the event before it.", "Put the event first, then its description indented below it."),
+  "markdown/timeline-events": entry("format", "error", "A timeline fence has no events.", "A timeline is drawn from its events.", "Write one event per line, for example `2024 Q1 \u2014 Pilot`."),
+  "markdown/opf-slide": entry("format", "error", "The YAML of an `opf-slide` fence is not valid.", YAML_WHY, "Fix the line the message names."),
+  "markdown/opf-slide-not-mapping": entry("format", "error", "An `opf-slide` fence is not a mapping.", "The fence holds the slide's fields as `key: value` lines.", "Write `key: value` lines."),
+  "markdown/opf-block": entry("format", "error", "The YAML of an `opf-block` fence is not valid.", YAML_WHY, "Fix the line the message names."),
+  "markdown/opf-block-not-mapping": entry("format", "error", "An `opf-block` fence is not a mapping.", "The fence holds the block's fields as `key: value` lines.", "Write `key: value` lines."),
+  "markdown/slide-property-conflict": entry("format", "error", "A slide field is set in the Markdown and in the `opf-slide` fence.", "Two values for one field leave it unclear which wins.", "Keep it in one place."),
+  "markdown/duplicate-title": entry("format", "error", "A slide has more than one `#` title.", "A slide has one title; a second `#` is the start of the next slide.", "Use `---` to start a new slide, or `##` for the subtitle."),
+  "markdown/duplicate-subtitle": entry("format", "error", "A slide has more than one `##` subtitle.", "A slide has one subtitle.", "Write further lines as paragraphs."),
+  "markdown/empty-heading": entry("format", "error", "A heading has no text.", "An empty title is an empty field.", "Write the title after the `#`, or remove the line."),
+  "markdown/empty-quote": entry("format", "error", "A block quote has no text.", "A quote without text draws nothing.", "Write the quote after `>`."),
+  "markdown/image-source": entry("format", "error", "An image has no source.", "A picture needs a file or an address.", "Write it inside the parentheses: `![alt](path.png)`."),
+  "markdown/heading-demoted": entry("format", "warning", "A heading below level 2 has no OPF form.", "Only `#` (title) and `##` (subtitle) are slide fields.", "Use a bold paragraph on purpose to silence this."),
+  "markdown/empty-slide": entry("format", "warning", "Two `---` lines in a row gave an empty slide.", "The empty slide was skipped.", "Remove the extra `---`, or write `<!-- slide -->` to keep it."),
+  "markdown/numbered-list": entry("format", "warning", "List numbers are not kept.", "The dialect does not read numbers as `numbering`, so each item became a bullet.", "Add `numbering` in an `opf-slide` fence, or use a bulleted list.", "1. one\n2. two", "```opf-slide\nitems:\n  - one\n  - two\nnumbering: decimal\n```"),
+  "markdown/table-ragged": entry("format", "warning", "A table row has a different number of cells than the header.", "Missing cells are empty.", "Give every row the same number of cells."),
+  "markdown/formatting-dropped": entry("format", "warning", "Inline formatting was dropped.", "The field takes a plain string.", "Use plain text here, or put the field in an `opf-slide` fence.")
+};
+
+// src/finding-text.ts
+var ID = "an id of lowercase letters, digits and hyphens that starts with a letter, like `my-layout`";
+var ID_NEXT = "use lowercase letters, digits and hyphens, and start with a letter.";
+var LANGUAGE = "a language tag like `en-US` or `de`";
+var PATTERN_PHRASES = Object.freeze({
+  "^#(?:[0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$": { what: "a hex color like `#1F4E79` (3, 6 or 8 hex digits)", next: "write the color as #RRGGBB." },
+  "^[a-z][a-z0-9-]*$": { what: ID, next: ID_NEXT },
+  "^[a-z0-9][a-z0-9-]*$": { what: "an id of lowercase letters, digits and hyphens, like `my-chart`", next: ID_NEXT },
+  "^(?:[a-z][a-z0-9-]*:)?[a-z][a-z0-9-]*$": { what: "a catalog id like `pillars` or `acme:hero` (lowercase letters, digits and hyphens)", next: "use the id of a record, with the catalog group in front when it has one." },
+  "^[a-zA-Z0-9][a-zA-Z0-9._-]*$": { what: "an id of letters, digits, dots, hyphens and underscores that starts with a letter or digit, like `logo-2`", next: "use letters, digits, dots, hyphens and underscores, without spaces." },
+  "^[a-zA-Z0-9_-]+$": { what: "an id of letters, digits, hyphens and underscores, like `hero_1`", next: "remove spaces and other punctuation." },
+  "^var:[a-z][a-z0-9-]*$": { what: "a variable reference like `var:brand`", next: "write `var:` and the id of a variable under `variables`." },
+  "^var:organization(\\.[A-Za-z0-9_-]+)?\\.logo(\\.(full|stacked|icon|wordmark))?$": { what: "an organization logo reference like `var:organization.logo.full`", next: "write `var:organization.logo` and, if you want, `.full`, `.stacked`, `.icon` or `.wordmark`." },
+  "^\\d{4}-\\d{2}-\\d{2}$": { what: "a date written year-month-day, like `2026-10-24`", next: "write the date as YYYY-MM-DD." },
+  "^(?:https?://|mailto:|tel:)\\S+$": { what: "a web, email or phone address (`https://\u2026`, `mailto:\u2026` or `tel:\u2026`)", next: "start with https://, mailto: or tel:, and leave out spaces." },
+  "^(https?://|mailto:|tel:)\\S+$": { what: "a web, email or phone address (`https://\u2026`, `mailto:\u2026` or `tel:\u2026`)", next: "start with https://, mailto: or tel:, and leave out spaces." },
+  "^(asset:|https://|data:|\\./|\\.\\./)": { what: "a source that starts with `asset:`, `https://`, `data:`, `./` or `../`", next: "register the file under `assets` and write `asset:` and its id, or give an https:// address." },
+  "^(?:https://[^\\s]+|pkg:[^\\s]+)$": { what: "an `https://` address or a `pkg:` reference", next: "write an address that starts with https:// or pkg:, without spaces." },
+  "^(?:[A-Za-z]{2,3}|[iIxX])(?:-[A-Za-z0-9]{1,8})*$": { what: LANGUAGE, next: "write a language and, if needed, a region: `en-US`, `pt-BR`, `de`." },
+  "^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$": { what: LANGUAGE, next: "write a language and, if needed, a region: `en-US`, `pt-BR`, `de`." },
+  "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{1,8})*$": { what: LANGUAGE, next: "write a language and, if needed, a region: `en-US`, `pt-BR`, `de`." },
+  "^[0-9a-f]{64}$": { what: "a 64-character lowercase hex digest", next: "paste the SHA-256 digest in lowercase hex." },
+  "^[^/]+\\.json$": { what: "a file name that ends in `.json`, without folders", next: "write a plain file name such as `pillars.json`." },
+  "^[a-z][a-z0-9-]*\\.svg$": { what: "a file name like `pillars.svg`", next: "write the record id and `.svg`." },
+  "^[A-Za-z0-9][A-Za-z0-9._-]*/[A-Za-z0-9][A-Za-z0-9._-]*$": { what: "a rule id of two parts like `opf/text-contrast`", next: "write the producer, a slash and the rule name." }
+});
+var hasHex = (pattern) => typeof pattern === "string" && /^\^#\(\?:\[0-9a-fA-F\]/.test(pattern);
+function helpersFor(finding2, context) {
+  const segments = segmentsOf(finding2.path);
+  return {
+    segments,
+    valueAt: (path) => context.valueAt ? context.valueAt([...path]) : readAt(context.document, path),
+    get: (path) => context.valueAt ? context.valueAt([...path]) : readAt(context.document, path),
+    chord: context.chord ?? "Ctrl+Space",
+    format: context.format ?? "json"
+  };
+}
+var attempt = (run, fallback) => {
+  try {
+    return run();
+  } catch {
+    return fallback;
+  }
+};
+function schemaKeys(segments, context) {
+  if (context.keysOf) return context.keysOf(segments);
+  return attempt(() => [...new Set(schemaVariants(schemaAtPath(context.document, segments)).flatMap((variant) => Object.keys(variant.properties ?? {})))], []);
+}
+function starterText(schema, property, format) {
+  const example = schema?.examples?.find((value) => typeof value === "string" && !value.includes("..."));
+  const type = Array.isArray(schema?.type) ? schema?.type[0] : schema?.type;
+  if (example !== void 0) return format === "json" ? JSON.stringify(example) : String(example);
+  if (type === "object") return "{ \u2026 }";
+  if (type === "array") return "[ \u2026 ]";
+  if (type === "number" || type === "integer") return "0";
+  if (type === "boolean") return "false";
+  if (property === "id") return format === "json" ? '"acme"' : "acme";
+  return format === "json" ? '"\u2026"' : "\u2026";
+}
+function describeSchema(finding2, context, helpers) {
+  const { keyword, params: params2 = {}, alternatives } = finding2.validation ?? { keyword: "" };
+  const segments = helpers.segments;
+  const label = fieldLabel(segments);
+  const actual = helpers.valueAt(segments);
+  const chord = helpers.chord;
+  const format = helpers.format;
+  switch (keyword) {
+    case "required": {
+      const property = String(params2.missingProperty ?? "");
+      const where = containerName(segments);
+      const schema = context.schemaAt ? context.schemaAt([...segments, property]) : attempt(() => schemaAtPath(context.document, [...segments, property]), void 0);
+      if (format === "json") {
+        const sample2 = property === "slides" ? '[ { "title": "\u2026" } ]' : starterText(schema, property, "json");
+        return { message: `${cap(where)} is missing ${code(property)}.`, next: `add "${property}": ${sample2}.` };
+      }
+      const sample = property === "slides" ? "slides:` with at least one `- title: \u2026" : `${property}: ${starterText(schema, property, "yaml")}`;
+      return { message: `${cap(where)} is missing ${code(property)}.`, next: `add \`${sample}\`.` };
+    }
+    case "type": {
+      const expected = typeWords(params2.type);
+      const next = params2.type === "array" && typeof actual === "string" ? `write [${JSON.stringify(actual)}].` : params2.type === "string" && typeof actual === "number" ? `write ${JSON.stringify(String(actual))}.` : params2.type === "string" && typeof actual === "boolean" ? `write ${JSON.stringify(String(actual))}.` : `write ${expected}.`;
+      return { message: `${cap(label)} should be ${expected}, but it is ${describeKind(actual)}.`, next };
+    }
+    case "oneOf":
+    case "anyOf": {
+      const forms = (alternatives ?? []).map((entry2) => String(entry2).split(":")[0]?.trim() ?? "");
+      const words = forms.length ? [...new Set(forms.map((form) => WORDS[form] ?? form))].slice(0, 3).join(" or ") : "a different kind of value";
+      return { message: `${cap(label)} should be ${words}, but it is ${describeKind(actual)}.`, next: forms.length ? `write ${words}.` : "check the schema reference for this field." };
+    }
+    case "enum": {
+      const values = params2.allowedValues ?? finding2.suggestions?.map((entry2) => entry2.value) ?? [];
+      const guess = nearest(actual, values).close[0];
+      const is = actual === void 0 ? "" : `, but is ${describeValue(actual)}`;
+      return {
+        message: `${cap(label)} must be ${valueList(values)}${is}.`,
+        next: guess !== void 0 ? `did you mean ${code(guess)}?` : values.length > 5 ? `press ${chord} for the ${values.length} values.` : "choose one of these values."
+      };
+    }
+    case "const":
+      return { message: `${cap(label)} must be exactly ${code(params2.allowedValue)}.`, next: `write ${JSON.stringify(params2.allowedValue)}.` };
+    case "pattern": {
+      const pattern = String(params2.pattern ?? "");
+      const kind = context.catalogKind ? context.catalogKind(segments) : attempt(() => catalogKindAt(segments, context.document), void 0);
+      actual === "" ? "it is empty" : `it is ${describeValue(actual)}`;
+      if (kind) {
+        const word = KIND_WORDS[kind] ?? "catalog";
+        const count = context.catalogCount?.(kind);
+        const ids = KIND_EXAMPLES[kind] ?? "`id` or `name:id`";
+        const press = `press ${chord}${count ? ` for the ${count} ${word}s` : " for the available ids"}`;
+        const orRemove = `, or remove it${kind === "layouts" ? " to let OPF pick" : ""}.`;
+        if (actual === "") return { message: `${cap(label)} is empty.`, next: `${press} (an id such as ${ids})${orRemove}` };
+        return {
+          message: `${cap(label)} must be a ${word} id such as ${ids} (lowercase letters, digits and hyphens), but it is ${describeValue(actual)}.`,
+          next: `${press}${orRemove}`
+        };
+      }
+      const phrase = PATTERN_PHRASES[pattern];
+      if (phrase) return { message: `${cap(label)} must be ${phrase.what}, but is ${describeValue(actual)}.`, next: phrase.next };
+      if (hasHex(pattern)) return { message: `${cap(label)} must be a hex color like ${code("#1F4E79")} (3, 6 or 8 hex digits), but is ${describeValue(actual)}.`, next: "write the color as #RRGGBB." };
+      return { message: `${cap(label)} does not match the expected format${typeof actual === "string" ? `: ${describeValue(actual)}` : ""}.`, next: "check the schema reference for this field." };
+    }
+    case "propertyNames": {
+      const name = String(params2.propertyName ?? "");
+      return { message: `${code(name)} is not a valid name here.`, next: "use letters, digits, hyphens and underscores, and start with a letter." };
+    }
+    case "additionalProperties": {
+      const name = String(params2.additionalProperty ?? segments.at(-1) ?? "");
+      const parent = segments.slice(0, -1);
+      const allowed = schemaKeys(parent, context);
+      const hint = nearest(name, allowed).close[0];
+      return {
+        message: `${code(name)} is not a property of ${containerName(parent)}.`,
+        next: `${hint ? `did you mean ${code(hint)}? ` : ""}To keep custom data, put it under ${code("extensions")}.`.trim()
+      };
+    }
+    case "minItems":
+      return { message: `${cap(label)} needs at least ${params2.limit} item${params2.limit === 1 ? "" : "s"}.`, next: label === "`slides`" ? "add a slide." : "add an item." };
+    case "maxItems":
+      return { message: `${cap(label)} can hold at most ${params2.limit} items.`, next: "remove the extra ones." };
+    case "minProperties":
+      return { message: `${cap(label)} needs at least ${params2.limit} propert${params2.limit === 1 ? "y" : "ies"}.`, next: "add one, or remove the empty object." };
+    case "uniqueItems":
+      return { message: `${cap(label)} repeats an entry.`, next: "remove the repeated entry." };
+    case "minLength":
+      return { message: `${cap(label)} is empty.`, next: "write some text, or remove the key." };
+    case "maxLength":
+      return { message: `${cap(label)} is longer than ${params2.limit} characters.`, next: "shorten it." };
+    case "minimum":
+    case "exclusiveMinimum":
+    case "maximum":
+    case "exclusiveMaximum": {
+      const bound = /minimum/i.test(keyword) ? "at least" : "at most";
+      return {
+        message: `${cap(label)} must be ${keyword.startsWith("exclusive") ? bound === "at least" ? "greater than" : "less than" : bound} ${params2.limit}, but is ${describeValue(actual)}.`,
+        next: `write ${params2.limit}${keyword.startsWith("exclusive") ? " or a different number" : ""}.`
+      };
+    }
+    case "format":
+      return { message: `${cap(label)} must be a ${params2.format === "uri" ? "web address like https://example.com" : params2.format}.`, next: "check the value." };
+    default:
+      return void 0;
+  }
+}
+function ruleText(finding2, context, helpers) {
+  const handler = RULE_TEXT[finding2.ruleId] ?? SOURCE_TEXT[finding2.ruleId];
+  return handler?.(finding2, context, helpers);
+}
+function describeFinding(finding2, context = {}) {
+  const helpers = helpersFor(finding2, context);
+  let described;
+  try {
+    if (finding2.ruleId === "opf/schema" && finding2.validation?.keyword) described = describeSchema(finding2, context, helpers);
+    else described = ruleText(finding2, context, helpers);
+  } catch {
+    described = void 0;
+  }
+  if (described) return described.next === void 0 ? { message: described.message, ...fallbackNext(finding2) } : described;
+  return { message: finding2.message, ...fallbackNext(finding2) };
+}
+function fallbackNext(finding2) {
+  const help = firstSentence(finding2.help);
+  return help ? { next: asNext(help) } : {};
+}
+function starterValue(document, segments, property) {
+  if (property === "slides" && segments.length === 0) return [{ title: "Slide title" }];
+  try {
+    return createSchemaValue(schemaAtPath(document, [...segments, property]));
+  } catch {
+    return void 0;
+  }
+}
+
+// src/schema-fixes.ts
+var MAX_CHANGES = 5;
+var patch = (id, title, operations, safe2 = false) => ({ id, title, kind: "patch", safe: safe2, patch: operations });
+var allowsKey = (document, segments, key2) => {
+  try {
+    return schemaVariants(schemaAtPath(document, segments)).some((variant) => Object.hasOwn(variant.properties ?? {}, key2));
+  } catch {
+    return false;
+  }
+};
+function schemaFixes(finding2, document) {
+  const validation = finding2.validation;
+  if (finding2.ruleId !== "opf/schema" || !validation) return [];
+  const segments = segmentsOf(finding2.path);
+  const params2 = validation.params;
+  switch (validation.keyword) {
+    case "required": {
+      const property = String(params2.missingProperty ?? "");
+      if (!property || !isRecord2(readAt(document, segments)) || Object.hasOwn(readAt(document, segments), property)) return [];
+      const value = starterValue(document, segments, property);
+      if (value === void 0) return [];
+      return [patch(`add:${property}`, `Add \`${property}\``, [{ op: "add", path: pointerOf([...segments, property]), value }])];
+    }
+    case "enum": {
+      const allowed = Array.isArray(params2.allowedValues) ? params2.allowedValues : [];
+      if (!allowed.length || readAt(document, segments) === void 0) return [];
+      const current = readAt(document, segments);
+      const values = [.../* @__PURE__ */ new Set([...nearest(current, allowed, MAX_CHANGES).close, ...allowed])].slice(0, MAX_CHANGES);
+      return values.map((value) => patch(`change-to:${String(value)}`, `Change to ${String(value)}`, [{ op: "replace", path: finding2.path, value }]));
+    }
+    case "additionalProperties": {
+      const name = String(params2.additionalProperty ?? segments.at(-1) ?? "");
+      const parent = segments.slice(0, -1);
+      const owner = readAt(document, parent);
+      if (!name || !isRecord2(owner) || !Object.hasOwn(owner, name)) return [];
+      const fixes = [];
+      for (const suggestion of finding2.suggestions ?? []) {
+        const target = String(suggestion.value);
+        if (!Object.hasOwn(owner, target)) fixes.push(patch(`rename-to:${target}`, `Rename to ${target}`, [{ op: "move", from: finding2.path, path: pointerOf([...parent, target]) }]));
+      }
+      if (allowsKey(document, parent, "extensions") && name !== "extensions") {
+        const existing = owner.extensions;
+        if (existing === void 0) fixes.push(patch("move-to-extensions", "Move into extensions", [{ op: "add", path: pointerOf([...parent, "extensions"]), value: {} }, { op: "move", from: finding2.path, path: pointerOf([...parent, "extensions", name]) }]));
+        else if (isRecord2(existing) && !Object.hasOwn(existing, name)) fixes.push(patch("move-to-extensions", "Move into extensions", [{ op: "move", from: finding2.path, path: pointerOf([...parent, "extensions", name]) }]));
+      }
+      return fixes;
+    }
+    case "type": {
+      const current = readAt(document, segments);
+      if (current === void 0) return [];
+      if (params2.type === "array" && (typeof current === "string" || isRecord2(current))) return [patch("wrap-in-list", "Wrap in a list", [{ op: "replace", path: finding2.path, value: [current] }], typeof current === "string")];
+      if (params2.type === "string" && (typeof current === "number" || typeof current === "boolean")) return [patch("convert-to-string", "Convert to string", [{ op: "replace", path: finding2.path, value: String(current) }], true)];
+      return [];
+    }
+    case "oneOf":
+    case "anyOf": {
+      const current = readAt(document, segments);
+      const forms = (validation.alternatives ?? []).map((entry2) => String(entry2).split(":")[0]?.trim());
+      if (forms.includes("string") && (typeof current === "number" || typeof current === "boolean")) return [patch("convert-to-string", "Convert to string", [{ op: "replace", path: finding2.path, value: String(current) }], true)];
+      return [];
+    }
+    case "minItems":
+      if (finding2.path === "/slides" && Array.isArray(readAt(document, segments)) && params2.limit === 1) return [patch("add-slide", "Add a slide", [{ op: "add", path: "/slides/0", value: { title: "Slide title" } }])];
+      return [];
+    default:
+      return [];
+  }
+}
+
 // src/script-measurement.ts
-function scriptProfile(presentation, slideIndex, options, language) {
+function scriptProfile(presentation, slideIndex, options2, language) {
   let resolved;
   try {
-    resolved = resolveScriptFonts(presentation, { slideIndex, ...options.catalogs !== void 0 ? { catalogs: options.catalogs } : {}, ...language === void 0 ? {} : { language } });
+    resolved = resolveScriptFonts(presentation, { slideIndex, ...options2.catalogs !== void 0 ? { catalogs: options2.catalogs } : {}, ...language === void 0 ? {} : { language } });
   } catch {
     resolved = void 0;
   }
   const slots = (role) => {
-    const latin = options.fontFamilies[role];
+    const latin = options2.fontFamilies[role];
     const slot = (key2) => !resolved || resolved.sources[key2] === "latin" || resolved.sources[key2] === "schemeFamily" ? latin : resolved[role][key2] ?? latin;
     return { latin, eastAsian: slot("eastAsian"), complexScript: slot("complexScript") };
   };
@@ -5373,13 +6974,13 @@ function scriptProfile(presentation, slideIndex, options, language) {
     script: resolved?.script ?? "Zzzz",
     ...resolved ? { scriptRole: resolved.scriptRole, bcp47: resolved.bcp47, lang: resolved.lang, languageSource: resolved.languageSource, direction: resolved.direction } : {},
     rtl: resolved?.rtl === true,
-    serif: options.serif
+    serif: options2.serif
   };
 }
-function slideScriptMeasurement(presentation, slideIndex, measurement, options) {
+function slideScriptMeasurement(presentation, slideIndex, measurement, options2) {
   const forScripts = measurement.forScripts;
   if (typeof forScripts !== "function") return measurement;
-  const deckProfile = scriptProfile(presentation, slideIndex, options);
+  const deckProfile = scriptProfile(presentation, slideIndex, options2);
   const deck = forScripts.call(measurement, deckProfile);
   const languages = /* @__PURE__ */ new Map();
   const forLanguage = (lang) => {
@@ -5387,7 +6988,7 @@ function slideScriptMeasurement(presentation, slideIndex, measurement, options)
     if (!languages.has(lang)) {
       let own4;
       try {
-        const profile = scriptProfile(presentation, slideIndex, options, lang);
+        const profile = scriptProfile(presentation, slideIndex, options2, lang);
         own4 = profile.languageSource === "option" && profile.bcp47?.toLowerCase() !== deckProfile.bcp47?.toLowerCase() ? forScripts.call(measurement, profile) : void 0;
       } catch {
         own4 = void 0;
@@ -5397,31 +6998,31 @@ function slideScriptMeasurement(presentation, slideIndex, measurement, options)
     return languages.get(lang);
   };
   const pick = (style) => forLanguage(style?.lang) ?? deck;
-  const scripted = { ...deck, measure: (text, size, style) => pick(style).measure(text, size, style) };
+  const scripted = { ...deck, measure: (text2, size, style) => pick(style).measure(text2, size, style) };
   if (typeof deck.resolveStyle === "function") scripted.resolveStyle = (style) => deck.resolveStyle.call(deck, style);
   if (typeof deck.outlineBounds === "function")
-    scripted.outlineBounds = (text, size, style) => {
+    scripted.outlineBounds = (text2, size, style) => {
       const own4 = pick(style);
-      return typeof own4.outlineBounds === "function" ? own4.outlineBounds(text, size, style) : deck.outlineBounds.call(deck, text, size, style);
+      return typeof own4.outlineBounds === "function" ? own4.outlineBounds(text2, size, style) : deck.outlineBounds.call(deck, text2, size, style);
     };
   return scripted;
 }
-function resolveSlideScriptMeasurement(presentation, slideIndex, measurement, options = {}) {
+function resolveSlideScriptMeasurement(presentation, slideIndex, measurement, options2 = {}) {
   if (typeof measurement.forScripts !== "function") return measurement;
-  const { fontScheme } = resolveDesignRecords(presentation, slideIndex, options.catalogs !== void 0 ? { catalogs: options.catalogs } : {});
+  const { fontScheme } = resolveDesignRecords(presentation, slideIndex, options2.catalogs !== void 0 ? { catalogs: options2.catalogs } : {});
   const resolved = resolveFontFamilies(fontScheme);
-  const fontFamilies = { heading: options.fontFamilies?.heading ?? resolved.heading, body: options.fontFamilies?.body ?? resolved.body };
-  return slideScriptMeasurement(presentation, slideIndex, measurement, { ...options.catalogs !== void 0 ? { catalogs: options.catalogs } : {}, fontFamilies, serif: fontScheme.type === "serif" });
+  const fontFamilies = { heading: options2.fontFamilies?.heading ?? resolved.heading, body: options2.fontFamilies?.body ?? resolved.body };
+  return slideScriptMeasurement(presentation, slideIndex, measurement, { ...options2.catalogs !== void 0 ? { catalogs: options2.catalogs } : {}, fontFamilies, serif: fontScheme.type === "serif" });
 }
 
 // src/slide-context.ts
 var rec2 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
-function resolveSlideContext(presentation, index, options = {}) {
+function resolveSlideContext(presentation, index, options2 = {}) {
   const deck = rec2(presentation);
   const slides = Array.isArray(deck.slides) ? deck.slides : [];
   if (!Number.isInteger(index) || index < 0 || index >= slides.length) throw new RangeError(`Slide index ${String(index)} is outside the presentation's ${slides.length} slides.`);
   const slide = rec2(slides[index]);
-  const catalogs = { catalogs: checkCatalogsOption(options.catalogs, "resolveSlideContext") };
+  const catalogs = { catalogs: checkCatalogsOption(options2.catalogs, "resolveSlideContext") };
   const records = resolveDesignRecords(presentation, index, catalogs);
   const diagnostics = [...records.diagnostics];
   const { theme, colorScheme, fontScheme } = records;
@@ -5435,30 +7036,30 @@ function resolveSlideContext(presentation, index, options = {}) {
       layoutProvenance = provenanceOf(found);
     } else diagnostics.push(unresolvedReference(presentation, "layouts", slide.layout, `slides.${index}.layout`, catalogs));
   }
-  if (options.strictReferences && diagnostics.length) throw new OPFUnresolvedReferenceError(diagnostics);
+  if (options2.strictReferences && diagnostics.length) throw new OPFUnresolvedReferenceError(diagnostics);
   const roles = resolveColorRoles(colorScheme, colorChoice([rec2(slide.design), rec2(deck.design), theme], colorScheme, rec2(deck.variables)));
   const composeOptions = {
     ...resolveCanvasDimensions(design.dimensions ?? theme.dimensions),
     ...layout ? { layout } : {},
     presentation,
     slideIndex: index,
-    slideNumber: options.slideNumber ?? index + 1,
-    slideCount: options.slideCount ?? slides.length,
+    slideNumber: options2.slideNumber ?? index + 1,
+    slideCount: options2.slideCount ?? slides.length,
     fontFamilies: resolveFontFamilies(fontScheme),
     darkBackground: roles.dark,
     ...theme.background !== void 0 ? { themeBackground: theme.background } : {},
     // OPF 0.19: a theme may carry the shared design keys (between the deck's design and the layout record's).
     ...theme.design !== void 0 && rec2(theme.design) === theme.design ? { themeDesign: theme.design } : {},
-    ...options.fonts?.textMeasurement ? { textMeasurement: options.fonts.textMeasurement } : {},
-    ...options.date !== void 0 ? { date: options.date } : {}
+    ...options2.fonts?.textMeasurement ? { textMeasurement: options2.fonts.textMeasurement } : {},
+    ...options2.date !== void 0 ? { date: options2.date } : {}
   };
   const resolvedSlide = resolveSlideVariables(slide, { slideNumber: composeOptions.slideNumber, slideCount: composeOptions.slideCount, presentation, darkBackground: composeOptions.darkBackground === true });
   return { slide: resolvedSlide, options: composeOptions, diagnostics, resolved: { theme, colorScheme, roles, fontScheme, fontSchemePath: records.fontSchemePath, ...layout ? { layout } : {}, provenance: { ...layoutProvenance ? { layout: layoutProvenance } : {}, ...records.provenance } } };
 }
 
 // src/rule-slides.ts
-var measurementFor = (options, index) => {
-  const measurement = options.fonts?.textMeasurement;
+var measurementFor = (options2, index) => {
+  const measurement = options2.fonts?.textMeasurement;
   return typeof measurement === "function" ? measurement(index) : measurement;
 };
 var lazy = (compute) => {
@@ -5485,16 +7086,16 @@ function relax(value) {
   walk2(copy);
   return copy;
 }
-function buildSlides(document, options) {
+function buildSlides(document, options2) {
   const slides = Array.isArray(document.slides) ? document.slides : [];
   return slides.map((slide, index) => {
     const path = pointer2("slides", index);
-    const baseContext = lazy(() => resolveSlideContext(document, index, { catalogs: options.catalogs, date: "2000-01-01" }));
+    const baseContext = lazy(() => resolveSlideContext(document, index, { catalogs: options2.catalogs, date: "2000-01-01" }));
     const measurement = lazy(() => {
-      const host = measurementFor(options, index);
+      const host = measurementFor(options2, index);
       if (!host) return void 0;
       const { resolved: resolved2 } = baseContext();
-      return slideScriptMeasurement(document, index, host, { catalogs: options.catalogs, fontFamilies: resolveFontFamilies(resolved2.fontScheme), serif: resolved2.fontScheme.type === "serif" });
+      return slideScriptMeasurement(document, index, host, { catalogs: options2.catalogs, fontFamilies: resolveFontFamilies(resolved2.fontScheme), serif: resolved2.fontScheme.type === "serif" });
     });
     const resolved = lazy(() => {
       const textMeasurement = measurement();
@@ -5549,7 +7150,6 @@ function buildSlides(document, options) {
 // src/validator.ts
 var SEVERITIES = ["error", "warning", "info"];
 var OPTION_KEYS = ["only", "ignore", "severity", "ignorePaths", "catalogs", "contracts", "thresholds", "fonts", "chartPalette", "template", "values"];
-var DOCS = "https://github.com/OpenPresentation/opf/blob/main/docs/validate.md";
 var isObject2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var OPFValidationError = class extends Error {
   /** The full report that failed. */
@@ -5557,7 +7157,7 @@ var OPFValidationError = class extends Error {
   /** The error-severity findings of the report. */
   findings;
   constructor(report2) {
-    const errors = report2.findings.filter((entry) => entry.severity === "error");
+    const errors = report2.findings.filter((entry2) => entry2.severity === "error");
     const first = errors[0];
     super(first ? `OPF validation failed at ${first.path || "/"}: ${first.message}` : "OPF validation failed");
     this.name = "OPFValidationError";
@@ -5573,7 +7173,7 @@ function ruleFor(name, what) {
 }
 function names(list, what) {
   if (list === void 0) return void 0;
-  if (!Array.isArray(list) || !list.every((entry) => typeof entry === "string")) throw new TypeError(`Validate ${what} must be an array of rule ids or category names.`);
+  if (!Array.isArray(list) || !list.every((entry2) => typeof entry2 === "string")) throw new TypeError(`Validate ${what} must be an array of rule ids or category names.`);
   const result = { rules: /* @__PURE__ */ new Set(), categories: /* @__PURE__ */ new Set() };
   for (const name of list) {
     const found = ruleFor(name, what);
@@ -5582,65 +7182,65 @@ function names(list, what) {
   }
   return result;
 }
-function resolveOptions(options) {
-  if (!isObject2(options)) throw new TypeError("Validate options must be an object.");
-  for (const key2 of Object.keys(options)) if (!OPTION_KEYS.includes(key2)) throw new TypeError(`Unknown validate option ${JSON.stringify(key2)}. Options: ${OPTION_KEYS.join(", ")}.`);
-  checkDocumentOptions(options);
-  const only = names(options.only, "only");
-  const ignore = names(options.ignore, "ignore");
+function resolveOptions(options2) {
+  if (!isObject2(options2)) throw new TypeError("Validate options must be an object.");
+  for (const key2 of Object.keys(options2)) if (!OPTION_KEYS.includes(key2)) throw new TypeError(`Unknown validate option ${JSON.stringify(key2)}. Options: ${OPTION_KEYS.join(", ")}.`);
+  checkDocumentOptions(options2);
+  const only = names(options2.only, "only");
+  const ignore = names(options2.ignore, "ignore");
   const severity = /* @__PURE__ */ new Map();
-  if (options.severity !== void 0) {
-    if (!isObject2(options.severity)) throw new TypeError('Validate severity must map rule ids or category names to a severity or "off".');
-    for (const [name, value] of Object.entries(options.severity)) {
+  if (options2.severity !== void 0) {
+    if (!isObject2(options2.severity)) throw new TypeError('Validate severity must map rule ids or category names to a severity or "off".');
+    for (const [name, value] of Object.entries(options2.severity)) {
       if (typeof value !== "string" || value !== "off" && !SEVERITIES.includes(value)) throw new TypeError(`Validate severity for ${JSON.stringify(name)} must be error, warning, info or off.`);
       const found = ruleFor(name, "severity");
       severity.set(typeof found === "string" ? found : found.id, value);
     }
   }
   const ignorePaths = [];
-  if (options.ignorePaths !== void 0) {
-    if (!Array.isArray(options.ignorePaths)) throw new TypeError("Validate ignorePaths must be an array of {rule, path}.");
-    for (const entry of options.ignorePaths) {
-      if (!isObject2(entry) || typeof entry.rule !== "string" || typeof entry.path !== "string" || entry.path !== "" && !entry.path.startsWith("/"))
+  if (options2.ignorePaths !== void 0) {
+    if (!Array.isArray(options2.ignorePaths)) throw new TypeError("Validate ignorePaths must be an array of {rule, path}.");
+    for (const entry2 of options2.ignorePaths) {
+      if (!isObject2(entry2) || typeof entry2.rule !== "string" || typeof entry2.path !== "string" || entry2.path !== "" && !entry2.path.startsWith("/"))
         throw new TypeError('Each validate ignorePaths entry needs a rule id, category name or "*", and a JSON Pointer path.');
-      const found = entry.rule === "*" ? "*" : ruleFor(entry.rule, "ignorePaths");
+      const found = entry2.rule === "*" ? "*" : ruleFor(entry2.rule, "ignorePaths");
       ignorePaths.push({
         match: (info) => found === "*" || (typeof found === "string" ? found === info.category : found.id === info.id),
-        path: splitPointer(entry.path)
+        path: splitPointer(entry2.path)
       });
     }
   }
   const thresholds = { ...DEFAULT_VALIDATION_THRESHOLDS };
-  if (options.thresholds !== void 0) {
-    if (!isObject2(options.thresholds)) throw new TypeError("Validate thresholds must be an object.");
-    for (const [key2, value] of Object.entries(options.thresholds)) {
+  if (options2.thresholds !== void 0) {
+    if (!isObject2(options2.thresholds)) throw new TypeError("Validate thresholds must be an object.");
+    for (const [key2, value] of Object.entries(options2.thresholds)) {
       if (!(key2 in DEFAULT_VALIDATION_THRESHOLDS)) throw new TypeError(`Unknown validate threshold ${JSON.stringify(key2)}. Thresholds: ${Object.keys(DEFAULT_VALIDATION_THRESHOLDS).join(", ")}.`);
       if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) throw new TypeError(`Validate threshold ${key2} must be a positive number.`);
       thresholds[key2] = value;
     }
   }
-  if (options.fonts !== void 0) {
-    if (!isObject2(options.fonts)) throw new TypeError("Validate fonts must be a fonts object with a textMeasurement.");
-    const measurement = options.fonts.textMeasurement;
+  if (options2.fonts !== void 0) {
+    if (!isObject2(options2.fonts)) throw new TypeError("Validate fonts must be a fonts object with a textMeasurement.");
+    const measurement = options2.fonts.textMeasurement;
     if (measurement !== void 0 && typeof measurement !== "function" && !isObject2(measurement)) throw new TypeError("Validate fonts.textMeasurement must be a text measurement, or a function of the slide index.");
   }
-  if (options.chartPalette !== void 0 && (!Array.isArray(options.chartPalette) || !options.chartPalette.every((color) => typeof color === "string" && /^#[0-9a-fA-F]{6}$/.test(color))))
+  if (options2.chartPalette !== void 0 && (!Array.isArray(options2.chartPalette) || !options2.chartPalette.every((color) => typeof color === "string" && /^#[0-9a-fA-F]{6}$/.test(color))))
     throw new TypeError("Validate chartPalette must be an array of #RRGGBB colours.");
-  if (options.template !== void 0 && typeof options.template !== "boolean") throw new TypeError("Validate template must be true or false.");
-  if (options.values !== void 0 && !isObject2(options.values)) throw new TypeError("Validate values must be an object keyed by variable id.");
+  if (options2.template !== void 0 && typeof options2.template !== "boolean") throw new TypeError("Validate template must be true or false.");
+  if (options2.values !== void 0 && !isObject2(options2.values)) throw new TypeError("Validate values must be an object keyed by variable id.");
   const level = (info) => severity.get(info.id) ?? severity.get(info.category);
   const off = (info) => level(info) === "off" || !!ignore?.rules.has(info.id) || !!ignore?.categories.has(info.category);
   return {
-    options,
+    options: options2,
     off,
     enabled: (info) => !off(info) && (!only || only.rules.has(info.id) || only.categories.has(info.category)),
     severity: (info) => {
       const value = level(info);
       return value === "off" ? void 0 : value;
     },
-    ignored: (info, path) => ignorePaths.some((entry) => entry.match(info) && entry.path.every((part, index) => path[index] === part)),
+    ignored: (info, path) => ignorePaths.some((entry2) => entry2.match(info) && entry2.path.every((part, index) => path[index] === part)),
     thresholds,
-    chartPalette: options.chartPalette
+    chartPalette: options2.chartPalette
   };
 }
 var order = new Map(validationRules.map((info, index) => [info.id, index]));
@@ -5648,25 +7248,25 @@ var categoryOrder = (category) => {
   const index = validationCategories.indexOf(category);
   return index < 0 ? validationCategories.length : index;
 };
-var auditInfos = ruleImplementations.flatMap((entry) => [entry.info, ...entry.also ?? []]);
+var auditInfos = ruleImplementations.flatMap((entry2) => [entry2.info, ...entry2.also ?? []]);
 var isLayoutRule = (info) => info.category === "layout" && info.cost === "composition";
 function slideOf(path) {
-  const match = /^\/slides\/(\d+)(?:\/|$)/.exec(path);
-  return match ? Number(match[1]) : void 0;
+  const match2 = /^\/slides\/(\d+)(?:\/|$)/.exec(path);
+  return match2 ? Number(match2[1]) : void 0;
 }
 function counts(findings) {
   const result = { error: 0, warning: 0, info: 0 };
-  for (const entry of findings) result[entry.severity]++;
+  for (const entry2 of findings) result[entry2.severity]++;
   return result;
 }
 var FIXED = { backgroundPixels: "not-read", imageBytes: "embedded-only", nativeExport: "not-checked" };
 function syntaxReport(parsed, run) {
   const findings = [];
-  for (const entry of parsed.syntax) {
-    const info = findValidationRule(entry.ruleId);
+  for (const entry2 of parsed.syntax) {
+    const info = findValidationRule(entry2.ruleId);
     if (info && run.off(info)) continue;
     const severity = info ? run.severity(info) : void 0;
-    findings.push(severity ? { ...entry, severity } : entry);
+    findings.push(severity ? { ...entry2, severity } : entry2);
   }
   const checks = {
     syntax: "checked",
@@ -5693,11 +7293,11 @@ function validateDocument(document, run, parsed) {
   if (enabledRule(findValidationRule("opf/variable-unfilled"))) findings.push(...variableFindings(document, engine, schemaValid));
   if (enabledRule(findValidationRule("opf/undeclared-catalog"))) findings.push(...undeclaredCatalogFindings(document));
   if (parsed) {
-    findings.push(...parsed.duplicates.filter((entry) => enabledRule(findValidationRule(entry.ruleId))));
+    findings.push(...parsed.duplicates.filter((entry2) => enabledRule(findValidationRule(entry2.ruleId))));
   }
   const referencesWanted = validationRules.some((info) => info.category === "references" && run.enabled(info));
   if (referencesWanted) {
-    findings.push(...referenceFindings(document, engine, run.options).filter((entry) => enabledRule(findValidationRule(entry.ruleId))));
+    findings.push(...referenceFindings(document, engine, run.options).filter((entry2) => enabledRule(findValidationRule(entry2.ruleId))));
   }
   const contracts = run.options.contracts ?? [];
   const contractRule = findValidationRule("opf/contract");
@@ -5716,7 +7316,7 @@ function validateDocument(document, run, parsed) {
       chartPalette: run.chartPalette,
       report(info, input) {
         const severity = run.severity(info) ?? input.severity ?? info.severity;
-        const entry = {
+        const entry2 = {
           ruleId: info.id,
           severity,
           category: info.category,
@@ -5724,28 +7324,28 @@ function validateDocument(document, run, parsed) {
           path: input.path,
           message: input.message,
           help: input.help,
-          definition: `${DOCS}#${info.id.replace("/", "")}`,
+          definition: ruleDocumentation(info.id),
           ...input.slide ? { slide: input.slide.index, ...input.slide.id ? { slideId: input.slide.id } : {} } : {},
           ...input.measured ? { measured: input.measured } : {},
           ...input.fixes?.length ? { fixes: input.fixes } : {},
           ...input.suggestions ? { suggestions: input.suggestions } : {}
         };
-        if (run.enabled(info)) findings.push(entry);
-        return entry;
+        if (run.enabled(info)) findings.push(entry2);
+        return entry2;
       }
     };
-    for (const entry of ruleImplementations) {
-      const all = [entry.info, ...entry.also ?? []];
+    for (const entry2 of ruleImplementations) {
+      const all = [entry2.info, ...entry2.also ?? []];
       if (!all.some((info) => run.enabled(info))) continue;
       for (const info of all) if (run.enabled(info)) auditRan.add(info.id);
-      entry.run(context);
+      entry2.run(context);
     }
   }
   const finished = [];
-  for (const entry of findings) {
-    const info = findValidationRule(entry.ruleId);
+  for (const entry2 of findings) {
+    const info = findValidationRule(entry2.ruleId);
     const override = info ? run.severity(info) : void 0;
-    const next = override && override !== entry.severity ? { ...entry, severity: override } : entry;
+    const next = override && override !== entry2.severity ? { ...entry2, severity: override } : entry2;
     if (info && run.ignored(info, splitPointer(next.path))) continue;
     const index = slideOf(next.path);
     if (next.slide === void 0 && index !== void 0 && next.scope !== "context") {
@@ -5757,6 +7357,10 @@ function validateDocument(document, run, parsed) {
       const location = parsed.locate(next.path);
       if (location) next.location = location;
     }
+    if (next.ruleId === "opf/schema" && next.fixes === void 0 && next.scope !== "context") {
+      const fixes = schemaFixes(next, document);
+      if (fixes.length) next.fixes = fixes;
+    }
     finished.push(next);
   }
   finished.sort(
@@ -5784,17 +7388,17 @@ function validateDocument(document, run, parsed) {
     ...engine.template !== void 0 ? { template: engine.template, unfilledVariables: engine.unfilledVariables } : {}
   };
 }
-function validate(input, options = {}) {
-  const run = resolveOptions(options);
+function validate(input, options2 = {}) {
+  const run = resolveOptions(options2);
   if (typeof input === "string") {
     const parsed = parseSource(input);
     return parsed.syntax.length ? syntaxReport(parsed, run) : validateDocument(parsed.value, run, parsed);
   }
   return validateDocument(input, run);
 }
-function assertValid(value, options = {}) {
+function assertValid(value, options2 = {}) {
   if (typeof value === "string") throw new TypeError("assertValid takes a parsed presentation. Use validate(text) for JSON text.");
-  const report2 = validate(value, options);
+  const report2 = validate(value, options2);
   if (!report2.valid) throw new OPFValidationError(report2);
 }
 function validateCatalogRecord(kind, value) {
@@ -5820,4 +7424,4 @@ function assertValidCatalogRecord(kind, value) {
   if (!report2.valid) throw new OPFValidationError(report2);
 }
 
-export { CATALOG_SCHEMA, COMMON_KEYS, DEFAULT_VALIDATION_THRESHOLDS, OPFPatchError, OPFPatchValidationError, OPFValidationError, UNRANKED_PRIORITY, activeSchema, analyzeJsonSyntax, applyPatch, applyPatchWithInverse, applyTextEdits, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogKindAt, catalogSchemaNames, createLocator, createSchemaValue, describeField, escapePointerToken, findValidationRule, formatPointer, getAtPointer, hasPointer, invertPatch, isPromotedRegionKey, jsonEqual, listSchemaFields, normalizePatch, parsePointer, parseSource, pointerFromPath, readPointer, rememberByText, resolveSchema, resolveSlideContext, resolveSlideScriptMeasurement, schemaAtPath, schemaCatalogKinds, schemaLabel, schemaType, schemaVariants, splitOpfPath, splitPointer2 as splitPointer, unescapePointerToken, validate, validateCatalogRecord, validationCategories, validationRules };
+export { BLOCK_AS_VALUES, BLOCK_OPTION_KEYS, CATALOG_SCHEMA, COMMON_KEYS, DEFAULT_VALIDATION_THRESHOLDS, FENCE_ATTRIBUTES, FENCE_KINDS, LINE_KEYWORDS, METRIC_KEYS, OPFPatchError, OPFPatchValidationError, OPFValidationError, PATTERN_PHRASES, SLIDE_OPTION_KEYS, SOURCE_EXPLAIN, SPAN_FLAGS, SPAN_VALUES, UNRANKED_PRIORITY, activeSchema, analyzeJsonSyntax, applyPatch, applyPatchWithInverse, applyTextEdits, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogKindAt, catalogSchemaNames, createLocator, createSchemaValue, describeField, describeFinding, distance2 as distance, escapePointerToken, findValidationRule, formatPointer, getAtPointer, hasPointer, invertPatch, isPromotedRegionKey, jsonEqual, listSchemaFields, nearest, normalizePatch, parsePointer, parseSource, pointerFromPath, readPointer, rememberByText, resolveSchema, resolveSlideContext, resolveSlideScriptMeasurement, ruleDocumentation, schemaAtPath, schemaCatalogKinds, schemaLabel, schemaType, schemaVariants, segmentsOf, splitOpfPath, splitPointer2 as splitPointer, starterValue, unescapePointerToken, us, validate, validateCatalogRecord, validationCategories, validationRules };