@openpresentation/opf 0.26.5 → 0.26.6

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

@@ -1158,9 +1158,6 @@ function describeDurationRange(range) {
   return range.min !== void 0 ? `at least ${range.min} minutes` : `at most ${range.max} minutes`;
 }
 
-// src/rule-context.ts
-var rule = (id, category, severity, summary, rationale, extra = {}) => ({ id: `opf/${id}`, name: id, category, severity, cost: extra.cost ?? "structure", summary, rationale, ...extra });
-
 // src/rule-design.ts
 var rec = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : {};
 var toRgb = (hex) => {
@@ -1580,7 +1577,502 @@ function assetRefs(document, slide, slidePath, includeDeck) {
         out.push({ path: Array.isArray(document.speaker) ? `/speaker/${index}/photo` : "/speaker/photo", value: speaker.photo, kind: "speaker" });
     });
   }
-  return out;
+  return out;
+}
+
+// src/rule-info.ts
+var rule = (id, category, severity, summary, rationale, extra = {}) => ({ id: `opf/${id}`, name: id, category, severity, cost: extra.cost ?? "structure", summary, rationale, ...extra });
+
+// src/validation-types.ts
+var validationCategories = Object.freeze([
+  "format",
+  "references",
+  "policy",
+  "accessibility",
+  "layout",
+  "content"
+]);
+
+// src/validation-rule-info.ts
+var DEFAULT_VALIDATION_THRESHOLDS = Object.freeze({
+  contrastNormal: 4.5,
+  contrastLarge: 3,
+  minFontSizePt: 11,
+  minImagePpi: 96,
+  minSeriesColorDifference: 10
+});
+var SCHEMA = "spec/schemas/opf.schema.json (JSON Schema 2020-12) and the semantic rules of OPF";
+var formatRules = [
+  rule(
+    "json-syntax",
+    "format",
+    "error",
+    "The text is not strict JSON.",
+    "Every OPF tool reads JSON. A misplaced comma, quote, comment or trailing comma makes the file unreadable, and the range says where.",
+    { cost: "syntax", standard: "RFC 8259 (strict JSON: no comments, no trailing commas)", approximations: "Only text input is checked. A string is always read as JSON. One finding per root cause, in position order and at most five (a key with no value, a missing comma, a bracket never closed; not the damage each one causes further on): `message` says what is wrong, `help` what to do next and `location` is the range to underline. A text that looks like YAML or Markdown gets one finding with a hint to use fromYaml or fromMarkdown first. Source editors get the same causes with their quick fixes from analyzeJsonSyntax (@openpresentation/opf/source)." }
+  ),
+  rule(
+    "duplicate-key",
+    "format",
+    "error",
+    "A JSON object repeats a key.",
+    "JSON.parse keeps only the last value of a repeated key, so the earlier one disappears without a trace. The check compares escaped and literal spellings of the same key.",
+    { cost: "syntax", standard: "RFC 8259 section 4 (names within an object should be unique)" }
+  ),
+  rule(
+    "schema",
+    "format",
+    "error",
+    "The document breaks the OPF schema or a structural rule the schema cannot express.",
+    "The schema is the contract every engine, exporter and editor relies on. A field of the wrong type, a missing required field, an unknown property or content fields that cannot be mixed make the document ambiguous or undrawable.",
+    { standard: SCHEMA, approximations: "All alternatives of a union are reported, with the failing schema location in `validation`. A required variable with no value is reported by `opf/variable-unfilled`, in the same category." }
+  ),
+  rule("reference-id-duplicate", "format", "error", "Two references share an id.", "A citation names a reference by id; a repeated id makes it ambiguous which entry is cited.", { standard: SCHEMA }),
+  rule("cite-unknown-reference", "format", "error", "A citation names a reference that does not exist.", "A cited id with no entry in `references` has nothing to show in the footnote area.", { standard: SCHEMA }),
+  rule("cite-unsupported-location", "format", "error", "A citation or footnote sits where no engine draws it.", "`cite` and `footnote` apply to runs in text, bullets and list items; table cells, captions, and reference and footnote texts have no marker.", { standard: SCHEMA }),
+  rule("caption-unsupported-payload", "format", "error", "A caption is on a payload that cannot carry one.", "A caption belongs to exactly one image, chart, table or video; a group, text or code block has no place to draw it.", { standard: SCHEMA }),
+  rule("image-option-unsupported-payload", "format", "error", "An image option is on a payload that is not an image.", "`fit`, `focus`, the image treatments (`shape`, `cornerRadius`, `border`, `opacity`, `recolor`, `overlay`, `aspectRatio`) and `placement` describe how a picture is drawn; a group, text or chart block has no picture for them to apply to.", { standard: SCHEMA }),
+  rule("image-placement-invalid", "format", "error", "An image placement cannot be honoured.", "A placed image bleeds to a slide edge and the rest of the slide composes beside it. Only a top-level block (slides.N.blocks.I) can do that, and a slide edge holds one placed image; a block in a group or a promoted region, or a second block on the same edge, has nowhere to go.", { standard: SCHEMA }),
+  rule("layout-placeholder-group", "format", "error", "A layout record's placeholder group breaks a nesting rule.", "A placeholder group arranges body regions inside one cell of its layout record. Groups nest at most three levels inside a record, and a group holds body regions and groups only: the headings (title, subtitle, tag) stay at the record's top level, where the engine places them. Composition cannot use a record that breaks either rule.", { standard: SCHEMA }),
+  rule("dataset-unknown", "format", "error", "A chart or table names a dataset that does not exist.", "The data cannot be drawn without the dataset it refers to.", { standard: SCHEMA }),
+  rule("dataset-field-unknown", "format", "error", "A table asks a dataset for a column it does not have.", "The column cannot be shown when the dataset has no column of that name.", { standard: SCHEMA }),
+  rule("data-column-duplicate", "format", "error", "A dataset or table has two columns with the same name.", "Series, mappings and fields address columns by name, so a repeated name makes them ambiguous.", { standard: SCHEMA }),
+  rule("chart-mapping-unknown-column", "format", "error", "A chart mapping names a column the data does not have.", "The series cannot be built from a column that is not there.", { standard: SCHEMA }),
+  rule("number-format-invalid", "format", "error", "A number format cannot be read.", "A format code that no engine can parse is drawn as the plain number or fails to export.", { standard: "Excel number format codes, as far as OPF supports them" }),
+  rule("variable-invalid-value", "format", "error", "A variable value does not match its declared type.", "A number variable given text, or a date given a non-date, cannot be filled into the deck.", { standard: SCHEMA }),
+  rule("variable-unknown-builtin", "format", "error", "A token names a built-in variable that does not exist.", "The `deck.`, `speaker.`, `organization.` and `slide.` names (and `speakers`) are reserved for built-in variables; a name under them that is not a built-in can never be filled, so the token would show literally. The slide-scoped `slide.number`, `slide.section` and `deck.slideCount` are inline tokens only, so `var:slide.*` and `var:deck.slideCount` are reported too; organization logos are whole-field references only (`var:organization.logo.icon`), so a `{{organization.logo}}` token, an unknown logo shape or an unknown organization id is reported.", { standard: SCHEMA }),
+  rule("chart-highlight-unknown-name", "format", "error", "A chart highlight names a series or category the chart does not have.", "`chart.highlight` emphasises marks by name; a name that matches no series or category in the chart data highlights nothing, so the chart is not drawn as authored.", { standard: SCHEMA }),
+  rule("variable-format", "format", "error", "A variable cannot be formatted.", "A number or date format that does not apply to the value leaves the token unreadable.", { standard: SCHEMA }),
+  rule(
+    "variable-unfilled",
+    "format",
+    "error",
+    "A required template variable has no value.",
+    "A variable a deck declares as required, with no value, is template scaffolding: `{{name}}` tokens show up literally and colour variables fall back to a default. A normal deck must be filled, so this is an error and the deck is not valid; a template (`template: true`) is incomplete on purpose, so it is a warning.",
+    {
+      approximations: "Required variables are those the variable machinery reports as unfilled for the document (declared, no value, not `required: false`, not given by the `values` option). For a document that declares no content variables, `{{id}}` / `{{id|format}}` tokens (`{{` escapes) left in any string outside `variables`, `extensions`, `catalogs` and `assets` are reported as warnings. `var:` colour references with no declaration are reported as `opf/variable-reference-unknown`. Fill a template with `opf fill` or `resolveVariables` to clear the findings."
+    }
+  ),
+  rule("run-color-unrecognized", "format", "warning", "A text run colour is none of the documented forms.", "Run colours are open strings so imported decks stay valid, but a value that is not a hex colour, a colour-scheme name or a `var:` reference falls back to the theme colour.", { standard: SCHEMA }),
+  rule("numbering-start-ignored", "format", "warning", "A list entry sets `start` where nothing is numbered.", "A start value only restarts an auto-number; without `numbering` on the payload it has no effect.", { standard: SCHEMA }),
+  rule(
+    "slide-size-out-of-range",
+    "format",
+    "warning",
+    "The slide size is outside PowerPoint's 1 to 56 inch range.",
+    "The schema accepts any positive custom `widthInches` and `heightInches`, but a PPTX stores the size as `p:sldSz` with each side between 914400 and 51206400 EMU, which is 1 to 56 inches. A custom size outside that range exports a file that does not conform to the standard, which PowerPoint may reject or clamp. It is a warning because the document is still correct OPF and the preview draws it.",
+    {
+      standard: "ECMA-376 / ISO/IEC 29500-1 section 19.2.1.39 (p:sldSz) and section 19.7.17 (ST_SlideSizeCoordinate): 914400 to 51206400 EMU",
+      approximations: "Checks the deck's resolved size: `design.dimensions`, else the resolved theme's `dimensions`. Inches are converted to EMU as the PPTX exporter does (`Math.round(inches * 914400)`), so a side of exactly 1 in or 56 in passes. A slide-level theme with another size is `opf/slide-theme-dimensions`. Presets are always in range. PowerPoint's own behaviour at the limits was not measured."
+    }
+  )
+];
+var referenceRules = [
+  rule(
+    "asset-reference",
+    "references",
+    "error",
+    "An `asset:` reference names an asset that is not in the registry.",
+    "An image, logo or video that points at a missing asset cannot be drawn or exported. The check reads the document's own registry only; no file or URL is fetched.",
+    { standard: SCHEMA }
+  ),
+  rule("asset-cycle", "references", "error", "Asset references form a cycle.", "An asset whose source points back at itself never resolves to a file.", { standard: SCHEMA }),
+  rule(
+    "catalog-record",
+    "references",
+    "error",
+    "An embedded or registered catalog record is invalid.",
+    "A record that fails its companion schema cannot be resolved. Invalid records are left out of the lookup, so the references to them are reported too.",
+    { standard: "spec/schemas/<kind>.schema.json" }
+  ),
+  rule(
+    "layout-template",
+    "references",
+    "error",
+    "A layout template's region list is malformed.",
+    `A layout is one ordered list of regions, nested through splits for two dimensions. Engines cannot compose a list that is not 1 to 12 entries, an entry that is neither a region nor a split, a direction or size that is not valid, an "auto" size anywhere but in a column, splits nested more than three levels deep (the record's own list is level 1), or regions that compile to a grid larger than 12 x 12. composeSlide refuses such a record, so a slide that names it composes automatically.`,
+    { standard: "spec/schemas/layout.schema.json and the region list rules (docs/layout-templates.md)", approximations: "Checked on every layout record the document embeds and every registered record it uses, once the record passes its schema." }
+  ),
+  rule(
+    "layout-region",
+    "references",
+    "error",
+    "A layout template's regions are not valid.",
+    "Region names are unique across the whole record and may not be tag, auto or a promoted-region word (left, center, right, top, middle, bottom), so a Markdown block's region= stays unambiguous; title and subtitle name the heading regions, which take only a size; a subtitle region needs a title region; a region accepts at least one content kind; a region with flow 'none' holds one block; overflowRegion must name a body region. composeSlide refuses such a record.",
+    { standard: "spec/schemas/layout.schema.json and the region rules (docs/layout-templates.md)" }
+  ),
+  rule(
+    "unresolved-reference",
+    "references",
+    "warning",
+    "A content reference resolves nowhere.",
+    "A layout, theme, colour scheme, font scheme, narrative, audience, purpose or tone reference that neither the document embeds nor a registered catalog defines falls back: a slide composes automatically, a design uses the engine default. A strict export fails instead. A slide with no layout is automatic composition and is never reported.",
+    { standard: SCHEMA, approximations: "Resolved like every engine resolves it: catalogs.custom, then the records embedded under catalogs.default, then the catalog registered for its source (the first registered catalog when `default` is omitted); `name:id` in catalogs.<name>, then the catalog registered for its source. Nothing is fetched. Free-form audience and purpose text is not a reference." }
+  ),
+  rule(
+    "catalog-record-not-in-source",
+    "references",
+    "warning",
+    "A record embedded under a catalog group is not in that catalog.",
+    "A record under catalogs.default or a named group says it came from the catalog its source names. When the catalog the host registered for that source has no record of that kind and id, the record is the document's own and belongs in catalogs.custom, where an update from the catalog never looks for it. Rendering is unchanged: the embedded record still wins.",
+    { standard: SCHEMA, approximations: "Checked only against a catalog the host registered for the group's source (the first registered catalog for an omitted default.source); with none registered for it the check is silent. A record the catalog has with different content is an update difference (updateFromCatalog), not this finding. catalogs.custom is never checked." }
+  ),
+  rule("undeclared-catalog", "format", "error", "A reference names a catalog group the document does not declare.", "The prefix of a `name:id` reference names the group of `catalogs` it resolves in. A prefix with no group can never resolve, whatever the host registers, so it is a format error: engines reject the document at their format check instead of drawing a fallback.", { standard: SCHEMA }),
+  rule("unused-reference", "references", "warning", "A reference is never cited.", "A listed reference that no run cites is not drawn anywhere.", { standard: SCHEMA }),
+  rule("unused-dataset", "references", "warning", "A dataset is never used.", "A dataset no chart or table references is not drawn anywhere.", { standard: SCHEMA }),
+  rule("unknown-beat", "references", "warning", "A slide names a beat its narrative does not define.", "`slides[].beat` links a slide to a step of the narrative plan. A beat id the narrative does not have links to nothing; nothing is drawn from a beat.", { standard: SCHEMA, approximations: "The narrative resolves like every content reference: the document's catalogs groups, then the registered catalogs. A narrative that resolves nowhere is not checked." }),
+  rule("slide-theme-dimensions", "references", "warning", "A slide theme sets a slide size that differs from the deck.", "A PPTX has one slide size. The size a slide-level theme carries is never used: design.dimensions of the deck (or of its theme) wins in every engine, and without them the exporter stops with mixed slide sizes.", { standard: SCHEMA }),
+  rule("variable-unknown", "references", "warning", "A `{{token}}` names a variable that is not declared.", "An undeclared token is shown literally.", { standard: SCHEMA }),
+  rule("variable-unknown-value", "references", "warning", "A value was supplied for a variable that is not declared.", "The value is never used.", { standard: SCHEMA }),
+  rule("variable-unused", "references", "warning", "A variable is declared but never used.", "A declaration nothing refers to has no effect.", { standard: SCHEMA }),
+  rule("variable-reference-unknown", "references", "warning", "A `var:` colour names a variable that is not declared.", "An undeclared colour variable falls back to a default colour.", { standard: SCHEMA })
+];
+var policyRules = [
+  rule(
+    "contract",
+    "policy",
+    "error",
+    "A field is outside the values a host policy allows.",
+    "A host that needs brand layouts, fonts or other fixed choices states them as contracts. The default severity is error; a contract can set its own. Document metadata never installs policy.",
+    { approximations: "Only the `contracts` option supplies policy, and it checks existing fields: a contract does not require an omitted field or insert a default." }
+  )
+];
+var dataRules = [
+  rule("chart-option-adapted", "layout", "warning", "A chart option cannot be shown by the chart type.", "An axis title, legend or data label option the chart type does not support is adapted by every engine, so the chart is not drawn exactly as authored.", { standard: SCHEMA }),
+  rule(
+    "chart-value-not-numeric",
+    "content",
+    "warning",
+    "A chart value is text, not a number.",
+    'A chart plots numbers. A text cell such as "12%" is plotted as a gap. When every text value of a column is written in one display style the finding carries the fix that stores the numbers and gives the column the matching format.',
+    { standard: SCHEMA }
+  ),
+  rule("chart-mapping-adapted", "content", "warning", "A chart mapping entry is ignored.", "A mapping that names a column the chart type cannot use is left out of the chart.", { standard: SCHEMA }),
+  rule("chart-highlight-adapted", "content", "warning", "A chart highlight is adapted by the chart type.", "A highlight the chart type cannot show as authored (a category highlight on a chart without categories, for example) is adapted by every engine, so the emphasis is not exactly what was written.", { standard: SCHEMA }),
+  rule("code-highlight-out-of-range", "content", "warning", "A code highlight marks a line the code does not have.", "Marked lines count from 1 by line break in code.source; an entry past the last line marks nothing.", { standard: SCHEMA }),
+  rule("code-highlight-range-reversed", "content", "warning", "A code highlight range ends before it starts.", "A range written end before start marks nothing; write the smaller line number first.", { standard: SCHEMA }),
+  rule("variable-builtin-missing", "content", "warning", "A built-in variable has no value in this document.", "A `{{deck.*}}`, `{{speaker.*}}` or `{{organization.*}}` token whose field the document does not set resolves to nothing, so the text shows a gap; a `var:organization.logo` reference to an organization without a logo draws no image. `{{slide.section}}` is checked per slide: a slide without a `section` that uses it, in its own text or in the header or footer it inherits, is reported at that slide.", { standard: SCHEMA }),
+  rule("duration-outside-narrative", "content", "warning", "The target duration is outside the range the narrative suits.", "A narrative records the talk lengths it suits. A deck whose duration is outside that range probably needs a different narrative or a different length; nothing is drawn or exported differently.", { standard: SCHEMA }),
+  rule("narrative-duration-range", "content", "warning", "An inline narrative duration range has min greater than max.", "A range with its bounds swapped matches no duration, so the duration check cannot help.", { standard: "spec/schemas/narrative.schema.json" })
+];
+var contrastRule = rule(
+  "text-contrast",
+  "accessibility",
+  "warning",
+  "Text colour has too little contrast against the background it sits on.",
+  "Low-contrast text is hard or impossible to read for people with low vision, colour-vision differences, glare on a projector or a poor display. WCAG sets 4.5:1 for normal text and 3:1 for large text.",
+  {
+    standard: "WCAG 2.2 SC 1.4.3 Contrast (Minimum), level AA",
+    thresholds: ["contrastNormal", "contrastLarge"],
+    cost: "composition",
+    approximations: "Computed on sRGB colours with the WCAG relative-luminance formula, against the background the preview draws: a solid or theme colour, the card surface, a table cell fill, every colour a gradient takes under the text box (sampled on a 5x5 grid, angle respected), or both colours of a pattern. Anti-aliasing, text shadows and font weight are not modelled. Text colour is the preview's (the scheme's text role or dark1 on a light background and light1 on a dark one, chosen from the background luminance, where a gradient or picture background uses the scheme's default background colour), so a default can fail on a dark gradient. A link with no colour of its own is measured in the scheme's hyperlink colour."
+  }
+);
+var onImageRule = rule(
+  "text-on-image",
+  "accessibility",
+  "info",
+  "Text sits on a background picture whose pixels cannot be measured.",
+  "Contrast over a photograph depends on the photograph. Without a full-frame overlay that guarantees readability for every possible image, the result cannot be certified from the document.",
+  {
+    standard: "WCAG 2.2 SC 1.4.3 Contrast (Minimum), level AA",
+    thresholds: ["contrastNormal", "contrastLarge"],
+    cost: "composition",
+    approximations: "Core never reads picture pixels. The picture is bounded by a grey ramp from black to white, composited through the image opacity and a full-frame design.background overlay; the text passes only when every step of that ramp passes. An edge-banded overlay is not counted."
+  }
+);
+var altRule = rule(
+  "missing-alt-text",
+  "accessibility",
+  "warning",
+  "A picture has no alt text and is not marked decorative.",
+  'People using a screen reader get nothing for a picture without alternative text. A picture that is purely decorative should say so with an empty alt (alt: ""), which is an explicit, reviewed choice instead of an omission.',
+  {
+    standard: "WCAG 2.2 SC 1.1.1 Non-text Content, level A",
+    approximations: "Checks the alt field of images (image blocks, Slide.image and region images, placed or not), video, organization logos (each shape and background), header/footer images (a logo reference such as var:organization.logo.icon is checked on the organization), quote photos and speaker photos, following asset: references to the assets registry. Whether the text describes the picture well is not judged here (see opf/poor-alt-text). Charts carry `chart.alt` and are checked by opf/chart-text-alternative. Picture backgrounds are decorative unless they carry their own alt, and watermarks are decorative, so neither is checked."
+  }
+);
+var poorAltRule = rule(
+  "poor-alt-text",
+  "accessibility",
+  "info",
+  "Alt text is a file name, a URL, a generic word or very long.",
+  'Alt text such as "image", "IMG_2041.png" or a 400-character paragraph does not do the job of describing a picture: it is read out and adds noise without information.',
+  { standard: "WCAG 2.2 SC 1.1.1 Non-text Content, level A", approximations: 'Pattern checks only: file extensions and camera-style names, a bare generic word, a URL, a leading "image of", and more than 250 characters. Chart alt text (chart.alt) is checked too: a bare chart word, a URL, a leading "chart of" or more than 250 characters. It cannot tell whether a plausible sentence is accurate.' }
+);
+var missingTitleRule = rule(
+  "missing-slide-title",
+  "accessibility",
+  "warning",
+  "A slide has no title.",
+  "Slide titles are how people using a screen reader, an outline view or keyboard navigation find and tell slides apart; PowerPoint's own accessibility checker reports a missing title too.",
+  { standard: 'WCAG 2.2 SC 2.4.2 Page Titled and SC 2.4.6 Headings and Labels, level AA (PowerPoint: "Missing slide title")', approximations: "Only the slide-level title field counts. Text that merely looks like a heading inside a block does not." }
+);
+var duplicateTitleRule = rule(
+  "duplicate-slide-title",
+  "accessibility",
+  "info",
+  "Two slides have the same title.",
+  "Identical titles make slides indistinguishable in an outline or a screen reader's slide list.",
+  { approximations: 'Titles are compared case-insensitively with whitespace collapsed. Slides that continue one another are not exempt; give a continuation a distinct title such as "(continued)".' }
+);
+var readingOrderRule = rule(
+  "reading-order",
+  "accessibility",
+  "warning",
+  "The order content is read differs from the order it appears on the slide.",
+  "Screen readers, keyboard focus and PowerPoint's selection pane follow the composed order. When it differs from the visual order (top to bottom, then start to end of the reading direction), the slide is read out of sequence.",
+  {
+    standard: 'WCAG 2.2 SC 1.3.2 Meaningful Sequence, level A (PowerPoint: "Check reading order")',
+    cost: "composition",
+    approximations: "Compares the composed content order with a visual order recomputed from the composed boxes: items whose vertical centres fall in the same row are ordered along the reading direction (a right-to-left deck is checked by rows only), rows from top to bottom. Headings are expected first. Free-form overlap is not analysed. On a slide with a template layout (OPF 0.19) the expected order is the binding order instead (the regions in reading order, then the blocks of each region), and items outside a region (placed images, the row below the grid) are not compared."
+  }
+);
+var linkRule = rule(
+  "link-text",
+  "accessibility",
+  "warning",
+  "Link text does not say where the link goes.",
+  `People who scan links out of context (a screen reader's links list, a link tab order) hear only the text. "click here", "read more" or a long raw URL tells them nothing about the destination.`,
+  { standard: 'WCAG 2.2 SC 2.4.4 Link Purpose (In Context), level A; PowerPoint: "Hyperlink text is not meaningful"', approximations: "Matches a short list of generic phrases in English (after lower-casing and removing punctuation), blank link text, and raw URLs longer than 40 characters. Adjacent runs sharing one link are read as one link." }
+);
+var chartColorRule = rule(
+  "chart-color-only",
+  "accessibility",
+  "info",
+  "Chart series may be indistinguishable without colour vision.",
+  "OPF charts have no data labels or patterns, so series are told apart by colour alone (and legend order). Colours that look alike to someone with colour-vision deficiency, or when printed in greyscale, make series impossible to tell apart.",
+  {
+    standard: "WCAG 2.2 SC 1.4.1 Use of Color, level A",
+    thresholds: ["minSeriesColorDifference"],
+    approximations: "Uses the engine's series palette (ValidateOptions.chartPalette; default chartSeriesPalette of each slide colour scheme (accent1 to accent6, then their tints), adjusted for the card surface like the preview does) in series order: series i takes colour i, pie/doughnut/treemap/funnel slices take colours per category. Pairs are compared by CIE76 distance after simulating protanopia, deuteranopia, tritanopia (Machado 2009, severity 1) and greyscale. Single-series charts and chart types without a series legend are skipped."
+  }
+);
+var chartAltRule = rule(
+  "chart-text-alternative",
+  "accessibility",
+  "info",
+  "A chart has no text alternative, or is marked decorative.",
+  "A chart conveys a message; people who cannot see it need the message and ideally the numbers in text. The chart's alt field is that text alternative (the preview exposes it as the chart's accessible name and the PowerPoint export writes it as the frame's alternative text); a sentence or table beside the chart also serves. An empty alt marks a chart decorative, which is reported as info so the choice is reviewed: a chart rarely carries no message.",
+  { standard: "WCAG 2.2 SC 1.1.1 Non-text Content, level A", approximations: `A chart passes when chart.alt has text. Without alt, it passes when the slide has any other text, list, table, quote or metric content besides title and tag, or a subtitle. It does not judge whether alt or that text states the chart's point (see opf/poor-alt-text for generic alt text). alt: "" is reported as a decorative chart, whatever else is on the slide.` }
+);
+var chartColorsRule = rule(
+  "chart-colors-adjusted",
+  "accessibility",
+  "warning",
+  "A chart colour cannot be used as authored.",
+  "`chart.colors` sets the colour of series 1, 2, 3 and so on. A colour that cannot be resolved (a `var:` colour variable the deck does not define, or a name that is not a colour) is ignored and the deck palette colour of that position is used. A colour with under 3:1 contrast against the chart panel is kept for its hue but drawn lighter or darker, so the chart does not show the colour that was written.",
+  {
+    standard: "WCAG 2.2 SC 1.4.11 Non-text Contrast, level AA",
+    approximations: "Resolves each entry like any colour reference (hex, colour-scheme slot or role, `var:` variable) against the slide's scheme and compares it with the chart panel (the slide surface colour) by WCAG contrast; 3:1 is the threshold the engines enforce. Translucent colours and unresolved panels are not measured. Colours that look alike to colour-vision deficiency are reported by opf/chart-color-only, which judges the authored colours."
+  }
+);
+var languageRule = rule(
+  "missing-language",
+  "accessibility",
+  "info",
+  "The presentation does not declare its language.",
+  "Screen readers and text-to-speech choose pronunciation and hyphenation from the declared language; spell checkers and translation tools use it too.",
+  { standard: "WCAG 2.2 SC 3.1.1 Language of Page, level A", approximations: "Only the presentation-level `language` is checked, not the language of individual runs (`TextRun.lang`; opf/language-tag checks how those tags are written)." }
+);
+var MAX_FURNITURE_LINES = 2;
+var overflowRule = rule(
+  "text-overflow",
+  "layout",
+  "warning",
+  "Text or a table does not fit its space at the smallest allowed size.",
+  "Core composition shrinks text to the readable minimum and then reports what still does not fit. Overflowing text is clipped or runs over other content in the preview and in PowerPoint.",
+  {
+    cost: "composition",
+    approximations: "Uses composeSlide at the deck's slide size with the fonts of the resolved font scheme. Without a host-supplied text measurement (ValidateOptions.fonts.textMeasurement) widths are core's portable estimate, which can differ from the real font by a few percent; pass the renderer's measurement for font-exact results. A composition that sets overflow: \"error\" is reported as a warning here, so that `valid` never depends on font metrics; rendering and export still refuse such a slide when it does not fit."
+  }
+);
+var unresolvedRule = rule(
+  "unresolved-content",
+  "layout",
+  "warning",
+  "Content cannot be drawn as authored.",
+  "composeSlide reports content it cannot place or an effect it does not support (for example a picture bullet without a logo, a date field without a date, or an unsupported image treatment). The preview and the export fall back.",
+  { cost: "composition" }
+);
+var layoutFailedRule = rule(
+  "layout-failed",
+  "layout",
+  "warning",
+  "The slide layout could not be computed.",
+  "Composition threw for a slide that passed schema validation, so geometry-based rules (contrast, overflow, reading order, resolution) were skipped for it.",
+  { cost: "composition" }
+);
+var minFontRule = rule(
+  "min-font-size",
+  "layout",
+  "warning",
+  "Text is drawn smaller than the readable minimum.",
+  "Small type is unreadable from the back of a room and on a phone. The engine's own default floor is 12 pt (16 px); anything much below that was lowered on purpose or by a composition that could not fit the text.",
+  {
+    cost: "composition",
+    standard: "Common presentation guidance (12 pt minimum for body text; 18 pt or more is easier to read from a distance).",
+    thresholds: ["minFontSizePt"],
+    approximations: "Sizes are those composeSlide fitted, expressed on the 13.33 x 7.5 in reference slide (96 px per inch, so 1 px is 0.75 pt; a smaller canvas scales type down with it) and explicit run fontSize values in points. Per payload, the smallest part (a metric label or a quote attribution) is reported. Table cell text (default 11.25 pt), code and header/footer furniture are not checked."
+  }
+);
+var regionUnknownRule = rule(
+  "region-unknown",
+  "layout",
+  "warning",
+  "A block is pinned to a region the layout does not have.",
+  "A region pin (`region` on a root block) names a region of the slide's layout. A name the layout does not have is ignored: the block is placed by its kind, which may not be where the author meant.",
+  { cost: "composition" }
+);
+var regionKindRule = rule(
+  "region-kind",
+  "layout",
+  "warning",
+  "A block is pinned to a region that does not accept its kind.",
+  "A region says which content kinds it takes. A pin to a region that does not take the block's kind is ignored and the block is placed by its kind.",
+  { cost: "composition" }
+);
+var regionFullRule = rule(
+  "region-full",
+  "layout",
+  "warning",
+  "A block is pinned to a region that is already full.",
+  "A region holds at most `max` blocks on one slide. A pin to a full region is ignored and the block is placed by its kind.",
+  { cost: "composition" }
+);
+var unplacedRule = rule(
+  "layout-unplaced",
+  "layout",
+  "warning",
+  "No region of the layout has room for a block.",
+  "Content is never dropped: a block no region has room for is drawn in the layout's overflow region beyond its max (or below the grid), where it crowds the others. Paginate moves it to a continuation slide with the same layout.",
+  { cost: "composition" }
+);
+var furnitureWrapsRule = rule(
+  "furniture-wraps",
+  "layout",
+  "warning",
+  `A header or footer zone wraps onto more than ${MAX_FURNITURE_LINES} lines.`,
+  "Header and footer text repeats on every slide in a band at the slide edge. A zone that wraps onto three or more lines grows into the body, and long source lines read poorly at footer size. Footers carry short repeated text (a title, a date, a page number); sources belong in a caption or the speaker notes.",
+  {
+    cost: "composition",
+    approximations: "Uses the lines core composed for the zone at the deck's slide size; without a host-supplied text measurement (ValidateOptions.fonts.textMeasurement) widths are core's portable estimates. A deck-level header or footer is reported once."
+  }
+);
+var outsideRule = rule(
+  "font-outside-scheme",
+  "layout",
+  "warning",
+  "Text uses a font family that is not in the deck's font scheme.",
+  "The font scheme is the deck's font choice. A run that names another family will not follow a font-scheme change, may be missing on the viewer's machine, and breaks the deck's typographic consistency.",
+  { approximations: "Compares the run's fontFamily (case-insensitively) with the heading, body, code and accent families of the slide's resolved font scheme and the scheme's major/minor fonts. Families that the host substitutes are still different names here." }
+);
+var resolutionRule = rule(
+  "image-resolution",
+  "layout",
+  "warning",
+  "An image has too few pixels for the size it is shown at.",
+  "An image stretched beyond its pixel size looks blurry or blocky on a projector or a high-density screen.",
+  {
+    cost: "composition",
+    thresholds: ["minImagePpi"],
+    approximations: "Only embedded data: images (and asset: references to them) have readable pixel sizes; URLs and files are never fetched, so they are not checked. The displayed size is the composed frame (cover and stretch are measured as the cover scale, contain as the contain scale). Effective ppi is the image pixels per inch of the 96 px/inch reference slide. SVG is vector and exempt."
+  }
+);
+var placeholderRule = rule(
+  "placeholder-text",
+  "content",
+  "warning",
+  "Placeholder text was left in the deck.",
+  '"Lorem ipsum", "Click to add title", "TBD" and bracketed prompts are scaffolding. Shipping them reads as unfinished work.',
+  { approximations: 'Case-insensitive patterns for lorem ipsum, template prompts ("Click to add...", "Your title here", "[Insert ...]", a bare "Title" or "Text"), and the markers TBD, TBC, TODO, FIXME and XXX in capitals. A deliberate use of the words is flagged too; disable the rule for that slide with ignorePaths.' }
+);
+var emptyTextRule = rule(
+  "empty-text",
+  "content",
+  "info",
+  "A text field is present but empty.",
+  "An empty title, text block or list item draws nothing, and leaves a hole in the outline and for assistive technology."
+);
+var emptySlideRule = rule(
+  "empty-slide",
+  "content",
+  "warning",
+  "A slide has no content at all.",
+  "A slide with no title, no content and no picture is almost always an accident of editing. (A deliberately blank slide can use the blank layout.)"
+);
+var unusedBeatRule = rule(
+  "unused-beat",
+  "content",
+  "info",
+  "A beat of the narrative has no slide that references it.",
+  "The narrative is the plan and the slides are the product. When some slides name a beat (slides[].beat) and a beat of the plan has none, the deck skips a step of the story or the plan is out of date.",
+  {
+    approximations: "Resolved like every content reference: the document's catalogs groups, then the registered catalogs. A narrative that resolves nowhere is not checked. A deck in which no slide references any beat is not checked either, because it has not linked its slides to the plan. A slide that lists several beats covers each of them."
+  }
+);
+var languageTagRule = rule(
+  "language-tag",
+  "content",
+  "warning",
+  "A language tag is malformed, uses an unassigned region or is not in canonical case.",
+  "Engines read the deck language and each run's `lang` as BCP 47 tags to choose script fonts, text direction, proofing language and the PowerPoint `lang` attribute. A tag such as `en-a`, or a region that does not exist (`en-UK`; the United Kingdom is `GB`), is guessed at or dropped, and a wrong-case tag (`EN-us`) is not what a locale lookup expects.",
+  {
+    standard: "BCP 47 (RFC 5646, section 2.1) and the platform locale data (Intl.getCanonicalLocales, Intl.DisplayNames)",
+    approximations: "Checks the root `language` (a tag string, or the `bcp47` of an inline Language object) and `lang` on the TextRun objects of titles, subtitles, tags, text, lists, tables, quotes, metrics and timelines. A region is assigned when the runtime's CLDR data names it (ISO 3166-1 codes and UN M.49 areas such as 419); private-use regions (`AA`, `QM`-`QZ`, `XA`-`XZ`) and `ZZ` are accepted, as are private-use (`x-...`) tags. Only the spelling of a tag is checked, not whether the language subtag is assigned or whether the language suits the text. The schema rejects tags with characters other than letters, digits and hyphens (`en_US` is a schema error, with no suggestion), and `en-UK` as the deck language is already an error of the schema rule, so those are not reported twice."
+  }
+);
+var implementedRules = [
+  contrastRule,
+  onImageRule,
+  altRule,
+  poorAltRule,
+  missingTitleRule,
+  duplicateTitleRule,
+  readingOrderRule,
+  linkRule,
+  chartColorRule,
+  chartColorsRule,
+  chartAltRule,
+  languageRule,
+  overflowRule,
+  unresolvedRule,
+  layoutFailedRule,
+  minFontRule,
+  regionUnknownRule,
+  regionKindRule,
+  regionFullRule,
+  unplacedRule,
+  furnitureWrapsRule,
+  outsideRule,
+  resolutionRule,
+  placeholderRule,
+  emptyTextRule,
+  unusedBeatRule,
+  emptySlideRule,
+  languageTagRule
+];
+var infos = [...formatRules, ...referenceRules, ...policyRules, ...dataRules, ...implementedRules];
+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 }))
+);
+var byName = /* @__PURE__ */ new Map();
+for (const info of validationRules) {
+  if (byName.has(info.id) || byName.has(info.name)) throw new Error(`Duplicate validation rule ${info.id}.`);
+  byName.set(info.id, info);
+  byName.set(info.name, info);
+}
+function findValidationRule(name) {
+  return byName.get(name);
+}
+function ruleInfo(id) {
+  const found = byName.get(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/rules-accessibility.ts
@@ -1683,32 +2175,6 @@ function collectSamples(context) {
       samples.push({ path: pointerOfDotted(part.sourcePath ?? part.path), color: design.colors.mutedText, sizePx: (part.fit?.fontSize ?? 13 * scale) / scale, bold: false, backdrop: slideBackdrop(context, part.box), source: "default", label: part.kind === "header" ? "Header text" : "Footer text" });
   return samples;
 }
-var contrastRule = rule(
-  "text-contrast",
-  "accessibility",
-  "warning",
-  "Text colour has too little contrast against the background it sits on.",
-  "Low-contrast text is hard or impossible to read for people with low vision, colour-vision differences, glare on a projector or a poor display. WCAG sets 4.5:1 for normal text and 3:1 for large text.",
-  {
-    standard: "WCAG 2.2 SC 1.4.3 Contrast (Minimum), level AA",
-    thresholds: ["contrastNormal", "contrastLarge"],
-    cost: "composition",
-    approximations: "Computed on sRGB colours with the WCAG relative-luminance formula, against the background the preview draws: a solid or theme colour, the card surface, a table cell fill, every colour a gradient takes under the text box (sampled on a 5x5 grid, angle respected), or both colours of a pattern. Anti-aliasing, text shadows and font weight are not modelled. Text colour is the preview's (the scheme's text role or dark1 on a light background and light1 on a dark one, chosen from the background luminance, where a gradient or picture background uses the scheme's default background colour), so a default can fail on a dark gradient. A link with no colour of its own is measured in the scheme's hyperlink colour."
-  }
-);
-var onImageRule = rule(
-  "text-on-image",
-  "accessibility",
-  "info",
-  "Text sits on a background picture whose pixels cannot be measured.",
-  "Contrast over a photograph depends on the photograph. Without a full-frame overlay that guarantees readability for every possible image, the result cannot be certified from the document.",
-  {
-    standard: "WCAG 2.2 SC 1.4.3 Contrast (Minimum), level AA",
-    thresholds: ["contrastNormal", "contrastLarge"],
-    cost: "composition",
-    approximations: "Core never reads picture pixels. The picture is bounded by a grey ramp from black to white, composited through the image opacity and a full-frame design.background overlay; the text passes only when every step of that ramp passes. An edge-banded overlay is not counted."
-  }
-);
 var contrastRules = [
   {
     info: contrastRule,
@@ -1769,25 +2235,6 @@ var contrastRules = [
   }
 ];
 var round = (value) => Math.round(value * 100) / 100;
-var altRule = rule(
-  "missing-alt-text",
-  "accessibility",
-  "warning",
-  "A picture has no alt text and is not marked decorative.",
-  'People using a screen reader get nothing for a picture without alternative text. A picture that is purely decorative should say so with an empty alt (alt: ""), which is an explicit, reviewed choice instead of an omission.',
-  {
-    standard: "WCAG 2.2 SC 1.1.1 Non-text Content, level A",
-    approximations: "Checks the alt field of images (image blocks, Slide.image and region images, placed or not), video, organization logos (each shape and background), header/footer images (a logo reference such as var:organization.logo.icon is checked on the organization), quote photos and speaker photos, following asset: references to the assets registry. Whether the text describes the picture well is not judged here (see opf/poor-alt-text). Charts carry `chart.alt` and are checked by opf/chart-text-alternative. Picture backgrounds are decorative unless they carry their own alt, and watermarks are decorative, so neither is checked."
-  }
-);
-var poorAltRule = rule(
-  "poor-alt-text",
-  "accessibility",
-  "info",
-  "Alt text is a file name, a URL, a generic word or very long.",
-  'Alt text such as "image", "IMG_2041.png" or a 400-character paragraph does not do the job of describing a picture: it is read out and adds noise without information.',
-  { standard: "WCAG 2.2 SC 1.1.1 Non-text Content, level A", approximations: 'Pattern checks only: file extensions and camera-style names, a bare generic word, a URL, a leading "image of", and more than 250 characters. Chart alt text (chart.alt) is checked too: a bare chart word, a URL, a leading "chart of" or more than 250 characters. It cannot tell whether a plausible sentence is accurate.' }
-);
 var GENERIC_ALT = /^(image|picture|photo|photograph|graphic|img|icon|figure|screenshot|untitled|alt|alt text|logo)$/i;
 var FILE_ALT = /(\.(png|jpe?g|gif|svg|webp|bmp|tiff?|heic|avif)$)|^(img|dsc|image|screenshot|screen shot|photo|pic)[ _-]?\d+/i;
 var GENERIC_CHART_ALT = /^((a|an|the)\s+)?([a-z-]+\s+){0,2}(chart|graph|plot|diagram|figure)$/i;
@@ -1864,22 +2311,6 @@ var altRules = [
     }
   }
 ];
-var missingTitleRule = rule(
-  "missing-slide-title",
-  "accessibility",
-  "warning",
-  "A slide has no title.",
-  "Slide titles are how people using a screen reader, an outline view or keyboard navigation find and tell slides apart; PowerPoint's own accessibility checker reports a missing title too.",
-  { standard: 'WCAG 2.2 SC 2.4.2 Page Titled and SC 2.4.6 Headings and Labels, level AA (PowerPoint: "Missing slide title")', approximations: "Only the slide-level title field counts. Text that merely looks like a heading inside a block does not." }
-);
-var duplicateTitleRule = rule(
-  "duplicate-slide-title",
-  "accessibility",
-  "info",
-  "Two slides have the same title.",
-  "Identical titles make slides indistinguishable in an outline or a screen reader's slide list.",
-  { approximations: 'Titles are compared case-insensitively with whitespace collapsed. Slides that continue one another are not exempt; give a continuation a distinct title such as "(continued)".' }
-);
 var titleRules = [
   {
     info: missingTitleRule,
@@ -1918,18 +2349,6 @@ var titleRules = [
     }
   }
 ];
-var readingOrderRule = rule(
-  "reading-order",
-  "accessibility",
-  "warning",
-  "The order content is read differs from the order it appears on the slide.",
-  "Screen readers, keyboard focus and PowerPoint's selection pane follow the composed order. When it differs from the visual order (top to bottom, then start to end of the reading direction), the slide is read out of sequence.",
-  {
-    standard: 'WCAG 2.2 SC 1.3.2 Meaningful Sequence, level A (PowerPoint: "Check reading order")',
-    cost: "composition",
-    approximations: "Compares the composed content order with a visual order recomputed from the composed boxes: items whose vertical centres fall in the same row are ordered along the reading direction (a right-to-left deck is checked by rows only), rows from top to bottom. Headings are expected first. Free-form overlap is not analysed. On a slide with a template layout (OPF 0.19) the expected order is the binding order instead (the regions in reading order, then the blocks of each region), and items outside a region (placed images, the row below the grid) are not compared."
-  }
-);
 var readingOrderRules = [
   {
     info: readingOrderRule,
@@ -1984,14 +2403,6 @@ function visualOrder(items, rtl) {
 }
 var shortField = (path) => path.replace(/^slides\.\d+\./, "");
 var ordinal = (index) => `position ${index + 1}`;
-var linkRule = rule(
-  "link-text",
-  "accessibility",
-  "warning",
-  "Link text does not say where the link goes.",
-  `People who scan links out of context (a screen reader's links list, a link tab order) hear only the text. "click here", "read more" or a long raw URL tells them nothing about the destination.`,
-  { standard: 'WCAG 2.2 SC 2.4.4 Link Purpose (In Context), level A; PowerPoint: "Hyperlink text is not meaningful"', approximations: "Matches a short list of generic phrases in English (after lower-casing and removing punctuation), blank link text, and raw URLs longer than 40 characters. Adjacent runs sharing one link are read as one link." }
-);
 var GENERIC_LINKS = /* @__PURE__ */ new Set(["click here", "click", "here", "link", "this link", "this", "read more", "more", "learn more", "see more", "more info", "more information", "details", "download", "url", "website", "web site", "page", "this page", "visit", "go"]);
 var linkRules = [
   {
@@ -2024,37 +2435,6 @@ var linkRules = [
     }
   }
 ];
-var chartColorRule = rule(
-  "chart-color-only",
-  "accessibility",
-  "info",
-  "Chart series may be indistinguishable without colour vision.",
-  "OPF charts have no data labels or patterns, so series are told apart by colour alone (and legend order). Colours that look alike to someone with colour-vision deficiency, or when printed in greyscale, make series impossible to tell apart.",
-  {
-    standard: "WCAG 2.2 SC 1.4.1 Use of Color, level A",
-    thresholds: ["minSeriesColorDifference"],
-    approximations: "Uses the engine's series palette (ValidateOptions.chartPalette; default chartSeriesPalette of each slide colour scheme (accent1 to accent6, then their tints), adjusted for the card surface like the preview does) in series order: series i takes colour i, pie/doughnut/treemap/funnel slices take colours per category. Pairs are compared by CIE76 distance after simulating protanopia, deuteranopia, tritanopia (Machado 2009, severity 1) and greyscale. Single-series charts and chart types without a series legend are skipped."
-  }
-);
-var chartAltRule = rule(
-  "chart-text-alternative",
-  "accessibility",
-  "info",
-  "A chart has no text alternative, or is marked decorative.",
-  "A chart conveys a message; people who cannot see it need the message and ideally the numbers in text. The chart's alt field is that text alternative (the preview exposes it as the chart's accessible name and the PowerPoint export writes it as the frame's alternative text); a sentence or table beside the chart also serves. An empty alt marks a chart decorative, which is reported as info so the choice is reviewed: a chart rarely carries no message.",
-  { standard: "WCAG 2.2 SC 1.1.1 Non-text Content, level A", approximations: `A chart passes when chart.alt has text. Without alt, it passes when the slide has any other text, list, table, quote or metric content besides title and tag, or a subtitle. It does not judge whether alt or that text states the chart's point (see opf/poor-alt-text for generic alt text). alt: "" is reported as a decorative chart, whatever else is on the slide.` }
-);
-var chartColorsRule = rule(
-  "chart-colors-adjusted",
-  "accessibility",
-  "warning",
-  "A chart colour cannot be used as authored.",
-  "`chart.colors` sets the colour of series 1, 2, 3 and so on. A colour that cannot be resolved (a `var:` colour variable the deck does not define, or a name that is not a colour) is ignored and the deck palette colour of that position is used. A colour with under 3:1 contrast against the chart panel is kept for its hue but drawn lighter or darker, so the chart does not show the colour that was written.",
-  {
-    standard: "WCAG 2.2 SC 1.4.11 Non-text Contrast, level AA",
-    approximations: "Resolves each entry like any colour reference (hex, colour-scheme slot or role, `var:` variable) against the slide's scheme and compares it with the chart panel (the slide surface colour) by WCAG contrast; 3:1 is the threshold the engines enforce. Translucent colours and unresolved panels are not measured. Colours that look alike to colour-vision deficiency are reported by opf/chart-color-only, which judges the authored colours."
-  }
-);
 var chartColorContext = (design) => ({
   roles: { primary: design.colors.primary, secondary: design.colors.secondary, accent: design.colors.accent, background: design.colors.background, surface: design.colors.surface, text: design.colors.text, textSecondary: design.colors.mutedText },
   variables: design.variables
@@ -2178,14 +2558,6 @@ var chartRules = [
     }
   }
 ];
-var languageRule = rule(
-  "missing-language",
-  "accessibility",
-  "info",
-  "The presentation does not declare its language.",
-  "Screen readers and text-to-speech choose pronunciation and hyphenation from the declared language; spell checkers and translation tools use it too.",
-  { standard: "WCAG 2.2 SC 3.1.1 Language of Page, level A", approximations: "Only the presentation-level `language` is checked, not the language of individual runs (`TextRun.lang`; opf/language-tag checks how those tags are written)." }
-);
 var languageRules = [
   {
     info: languageRule,
@@ -2270,17 +2642,6 @@ function languageTagProblem(tag) {
 }
 
 // src/rules-language.ts
-var languageTagRule = rule(
-  "language-tag",
-  "content",
-  "warning",
-  "A language tag is malformed, uses an unassigned region or is not in canonical case.",
-  "Engines read the deck language and each run's `lang` as BCP 47 tags to choose script fonts, text direction, proofing language and the PowerPoint `lang` attribute. A tag such as `en-a`, or a region that does not exist (`en-UK`; the United Kingdom is `GB`), is guessed at or dropped, and a wrong-case tag (`EN-us`) is not what a locale lookup expects.",
-  {
-    standard: "BCP 47 (RFC 5646, section 2.1) and the platform locale data (Intl.getCanonicalLocales, Intl.DisplayNames)",
-    approximations: "Checks the root `language` (a tag string, or the `bcp47` of an inline Language object) and `lang` on the TextRun objects of titles, subtitles, tags, text, lists, tables, quotes, metrics and timelines. A region is assigned when the runtime's CLDR data names it (ISO 3166-1 codes and UN M.49 areas such as 419); private-use regions (`AA`, `QM`-`QZ`, `XA`-`XZ`) and `ZZ` are accepted, as are private-use (`x-...`) tags. Only the spelling of a tag is checked, not whether the language subtag is assigned or whether the language suits the text. The schema rejects tags with characters other than letters, digits and hyphens (`en_US` is a schema error, with no suggestion), and `en-UK` as the deck language is already an error of the schema rule, so those are not reported twice."
-  }
-);
 var report = (context, tag, path, slide) => {
   if (typeof tag !== "string") return;
   const problem = languageTagProblem(tag);
@@ -2304,99 +2665,15 @@ var languageTagRules = [
       } else if (language !== void 0 && !isEnUk(rec(language).bcp47)) report(context, rec(language).bcp47, "/language/bcp47");
       for (const slide of context.slides)
         for (const tv of slide.texts)
-          if (typeof tv.value !== "string") for (const run of runsOf(tv)) report(context, run.style.lang, `${run.path}/lang`, slide);
-    }
-  }
-];
-
-// src/rules-layout-content.ts
-var PX_TO_PT2 = 0.75;
-var round2 = (value, places = 1) => Math.round(value * 10 ** places) / 10 ** places;
-var overflowRule = rule(
-  "text-overflow",
-  "layout",
-  "warning",
-  "Text or a table does not fit its space at the smallest allowed size.",
-  "Core composition shrinks text to the readable minimum and then reports what still does not fit. Overflowing text is clipped or runs over other content in the preview and in PowerPoint.",
-  {
-    cost: "composition",
-    approximations: "Uses composeSlide at the deck's slide size with the fonts of the resolved font scheme. Without a host-supplied text measurement (ValidateOptions.fonts.textMeasurement) widths are core's portable estimate, which can differ from the real font by a few percent; pass the renderer's measurement for font-exact results. A composition that sets overflow: \"error\" is reported as a warning here, so that `valid` never depends on font metrics; rendering and export still refuse such a slide when it does not fit."
-  }
-);
-var unresolvedRule = rule(
-  "unresolved-content",
-  "layout",
-  "warning",
-  "Content cannot be drawn as authored.",
-  "composeSlide reports content it cannot place or an effect it does not support (for example a picture bullet without a logo, a date field without a date, or an unsupported image treatment). The preview and the export fall back.",
-  { cost: "composition" }
-);
-var layoutFailedRule = rule(
-  "layout-failed",
-  "layout",
-  "warning",
-  "The slide layout could not be computed.",
-  "Composition threw for a slide that passed schema validation, so geometry-based rules (contrast, overflow, reading order, resolution) were skipped for it.",
-  { cost: "composition" }
-);
-var minFontRule = rule(
-  "min-font-size",
-  "layout",
-  "warning",
-  "Text is drawn smaller than the readable minimum.",
-  "Small type is unreadable from the back of a room and on a phone. The engine's own default floor is 12 pt (16 px); anything much below that was lowered on purpose or by a composition that could not fit the text.",
-  {
-    cost: "composition",
-    standard: "Common presentation guidance (12 pt minimum for body text; 18 pt or more is easier to read from a distance).",
-    thresholds: ["minFontSizePt"],
-    approximations: "Sizes are those composeSlide fitted, expressed on the 13.33 x 7.5 in reference slide (96 px per inch, so 1 px is 0.75 pt; a smaller canvas scales type down with it) and explicit run fontSize values in points. Per payload, the smallest part (a metric label or a quote attribution) is reported. Table cell text (default 11.25 pt), code and header/footer furniture are not checked."
-  }
-);
-var regionUnknownRule = rule(
-  "region-unknown",
-  "layout",
-  "warning",
-  "A block is pinned to a region the layout does not have.",
-  "A region pin (`region` on a root block) names a region of the slide's layout. A name the layout does not have is ignored: the block is placed by its kind, which may not be where the author meant.",
-  { cost: "composition" }
-);
-var regionKindRule = rule(
-  "region-kind",
-  "layout",
-  "warning",
-  "A block is pinned to a region that does not accept its kind.",
-  "A region says which content kinds it takes. A pin to a region that does not take the block's kind is ignored and the block is placed by its kind.",
-  { cost: "composition" }
-);
-var regionFullRule = rule(
-  "region-full",
-  "layout",
-  "warning",
-  "A block is pinned to a region that is already full.",
-  "A region holds at most `max` blocks on one slide. A pin to a full region is ignored and the block is placed by its kind.",
-  { cost: "composition" }
-);
-var unplacedRule = rule(
-  "layout-unplaced",
-  "layout",
-  "warning",
-  "No region of the layout has room for a block.",
-  "Content is never dropped: a block no region has room for is drawn in the layout's overflow region beyond its max (or below the grid), where it crowds the others. Paginate moves it to a continuation slide with the same layout.",
-  { cost: "composition" }
-);
-var REGION_RULES = { "region-unknown": regionUnknownRule, "region-kind": regionKindRule, "region-full": regionFullRule, "layout-unplaced": unplacedRule };
-var MAX_FURNITURE_LINES = 2;
-var furnitureWrapsRule = rule(
-  "furniture-wraps",
-  "layout",
-  "warning",
-  `A header or footer zone wraps onto more than ${MAX_FURNITURE_LINES} lines.`,
-  "Header and footer text repeats on every slide in a band at the slide edge. A zone that wraps onto three or more lines grows into the body, and long source lines read poorly at footer size. Footers carry short repeated text (a title, a date, a page number); sources belong in a caption or the speaker notes.",
-  {
-    cost: "composition",
-    approximations: "Uses the lines core composed for the zone at the deck's slide size; without a host-supplied text measurement (ValidateOptions.fonts.textMeasurement) widths are core's portable estimates. A deck-level header or footer is reported once."
+          if (typeof tv.value !== "string") for (const run of runsOf(tv)) report(context, run.style.lang, `${run.path}/lang`, slide);
+    }
   }
-);
+];
+
+// src/rules-layout-content.ts
+var PX_TO_PT2 = 0.75;
+var round2 = (value, places = 1) => Math.round(value * 10 ** places) / 10 ** places;
+var REGION_RULES = { "region-unknown": regionUnknownRule, "region-kind": regionKindRule, "region-full": regionFullRule, "layout-unplaced": unplacedRule };
 var layoutRules = [
   {
     info: overflowRule,
@@ -2477,14 +2754,6 @@ var layoutRules = [
     }
   }
 ];
-var outsideRule = rule(
-  "font-outside-scheme",
-  "layout",
-  "warning",
-  "Text uses a font family that is not in the deck's font scheme.",
-  "The font scheme is the deck's font choice. A run that names another family will not follow a font-scheme change, may be missing on the viewer's machine, and breaks the deck's typographic consistency.",
-  { approximations: "Compares the run's fontFamily (case-insensitively) with the heading, body, code and accent families of the slide's resolved font scheme and the scheme's major/minor fonts. Families that the host substitutes are still different names here." }
-);
 var fontRules = [
   {
     info: outsideRule,
@@ -2511,18 +2780,6 @@ var fontRules = [
     }
   }
 ];
-var resolutionRule = rule(
-  "image-resolution",
-  "layout",
-  "warning",
-  "An image has too few pixels for the size it is shown at.",
-  "An image stretched beyond its pixel size looks blurry or blocky on a projector or a high-density screen.",
-  {
-    cost: "composition",
-    thresholds: ["minImagePpi"],
-    approximations: "Only embedded data: images (and asset: references to them) have readable pixel sizes; URLs and files are never fetched, so they are not checked. The displayed size is the composed frame (cover and stretch are measured as the cover scale, contain as the contain scale). Effective ppi is the image pixels per inch of the 96 px/inch reference slide. SVG is vector and exempt."
-  }
-);
 var resolutionRules = [
   {
     info: resolutionRule,
@@ -2556,38 +2813,6 @@ var resolutionRules = [
     }
   }
 ];
-var placeholderRule = rule(
-  "placeholder-text",
-  "content",
-  "warning",
-  "Placeholder text was left in the deck.",
-  '"Lorem ipsum", "Click to add title", "TBD" and bracketed prompts are scaffolding. Shipping them reads as unfinished work.',
-  { approximations: 'Case-insensitive patterns for lorem ipsum, template prompts ("Click to add...", "Your title here", "[Insert ...]", a bare "Title" or "Text"), and the markers TBD, TBC, TODO, FIXME and XXX in capitals. A deliberate use of the words is flagged too; disable the rule for that slide with ignorePaths.' }
-);
-var emptyTextRule = rule(
-  "empty-text",
-  "content",
-  "info",
-  "A text field is present but empty.",
-  "An empty title, text block or list item draws nothing, and leaves a hole in the outline and for assistive technology."
-);
-var emptySlideRule = rule(
-  "empty-slide",
-  "content",
-  "warning",
-  "A slide has no content at all.",
-  "A slide with no title, no content and no picture is almost always an accident of editing. (A deliberately blank slide can use the blank layout.)"
-);
-var unusedBeatRule = rule(
-  "unused-beat",
-  "content",
-  "info",
-  "A beat of the narrative has no slide that references it.",
-  "The narrative is the plan and the slides are the product. When some slides name a beat (slides[].beat) and a beat of the plan has none, the deck skips a step of the story or the plan is out of date.",
-  {
-    approximations: "Resolved like every content reference: the document's catalogs groups, then the registered catalogs. A narrative that resolves nowhere is not checked. A deck in which no slide references any beat is not checked either, because it has not linked its slides to the plan. A slide that lists several beats covers each of them."
-  }
-);
 var PLACEHOLDERS = [
   { pattern: /lorem ipsum|dolor sit amet|consectetur adipiscing/i, label: "lorem ipsum" },
   { pattern: /\b(click|tap) to (add|edit|enter)\b|\b(add|enter|insert|type) (a |your |the )?(title|subtitle|text|heading|caption|content|name|description)( here)?\s*$/i, label: "a template prompt" },
@@ -2669,208 +2894,8 @@ var layoutContentRules = [
   ...contentRules
 ];
 
-// src/validation-types.ts
-var validationCategories = Object.freeze([
-  "format",
-  "references",
-  "policy",
-  "accessibility",
-  "layout",
-  "content"
-]);
-
 // src/validation-rules.ts
-var DEFAULT_VALIDATION_THRESHOLDS = Object.freeze({
-  contrastNormal: 4.5,
-  contrastLarge: 3,
-  minFontSizePt: 11,
-  minImagePpi: 96,
-  minSeriesColorDifference: 10
-});
-var SCHEMA = "spec/schemas/opf.schema.json (JSON Schema 2020-12) and the semantic rules of OPF";
-var formatRules = [
-  rule(
-    "json-syntax",
-    "format",
-    "error",
-    "The text is not strict JSON.",
-    "Every OPF tool reads JSON. A misplaced comma, quote, comment or trailing comma makes the file unreadable, and the range says where.",
-    { cost: "syntax", standard: "RFC 8259 (strict JSON: no comments, no trailing commas)", approximations: "Only text input is checked. A string is always read as JSON. One finding per root cause, in position order and at most five (a key with no value, a missing comma, a bracket never closed; not the damage each one causes further on): `message` says what is wrong, `help` what to do next and `location` is the range to underline. A text that looks like YAML or Markdown gets one finding with a hint to use fromYaml or fromMarkdown first. Source editors get the same causes with their quick fixes from analyzeJsonSyntax (@openpresentation/opf/source)." }
-  ),
-  rule(
-    "duplicate-key",
-    "format",
-    "error",
-    "A JSON object repeats a key.",
-    "JSON.parse keeps only the last value of a repeated key, so the earlier one disappears without a trace. The check compares escaped and literal spellings of the same key.",
-    { cost: "syntax", standard: "RFC 8259 section 4 (names within an object should be unique)" }
-  ),
-  rule(
-    "schema",
-    "format",
-    "error",
-    "The document breaks the OPF schema or a structural rule the schema cannot express.",
-    "The schema is the contract every engine, exporter and editor relies on. A field of the wrong type, a missing required field, an unknown property or content fields that cannot be mixed make the document ambiguous or undrawable.",
-    { standard: SCHEMA, approximations: "All alternatives of a union are reported, with the failing schema location in `validation`. A required variable with no value is reported by `opf/variable-unfilled`, in the same category." }
-  ),
-  rule("reference-id-duplicate", "format", "error", "Two references share an id.", "A citation names a reference by id; a repeated id makes it ambiguous which entry is cited.", { standard: SCHEMA }),
-  rule("cite-unknown-reference", "format", "error", "A citation names a reference that does not exist.", "A cited id with no entry in `references` has nothing to show in the footnote area.", { standard: SCHEMA }),
-  rule("cite-unsupported-location", "format", "error", "A citation or footnote sits where no engine draws it.", "`cite` and `footnote` apply to runs in text, bullets and list items; table cells, captions, and reference and footnote texts have no marker.", { standard: SCHEMA }),
-  rule("caption-unsupported-payload", "format", "error", "A caption is on a payload that cannot carry one.", "A caption belongs to exactly one image, chart, table or video; a group, text or code block has no place to draw it.", { standard: SCHEMA }),
-  rule("image-option-unsupported-payload", "format", "error", "An image option is on a payload that is not an image.", "`fit`, `focus`, the image treatments (`shape`, `cornerRadius`, `border`, `opacity`, `recolor`, `overlay`, `aspectRatio`) and `placement` describe how a picture is drawn; a group, text or chart block has no picture for them to apply to.", { standard: SCHEMA }),
-  rule("image-placement-invalid", "format", "error", "An image placement cannot be honoured.", "A placed image bleeds to a slide edge and the rest of the slide composes beside it. Only a top-level block (slides.N.blocks.I) can do that, and a slide edge holds one placed image; a block in a group or a promoted region, or a second block on the same edge, has nowhere to go.", { standard: SCHEMA }),
-  rule("layout-placeholder-group", "format", "error", "A layout record's placeholder group breaks a nesting rule.", "A placeholder group arranges body regions inside one cell of its layout record. Groups nest at most three levels inside a record, and a group holds body regions and groups only: the headings (title, subtitle, tag) stay at the record's top level, where the engine places them. Composition cannot use a record that breaks either rule.", { standard: SCHEMA }),
-  rule("dataset-unknown", "format", "error", "A chart or table names a dataset that does not exist.", "The data cannot be drawn without the dataset it refers to.", { standard: SCHEMA }),
-  rule("dataset-field-unknown", "format", "error", "A table asks a dataset for a column it does not have.", "The column cannot be shown when the dataset has no column of that name.", { standard: SCHEMA }),
-  rule("data-column-duplicate", "format", "error", "A dataset or table has two columns with the same name.", "Series, mappings and fields address columns by name, so a repeated name makes them ambiguous.", { standard: SCHEMA }),
-  rule("chart-mapping-unknown-column", "format", "error", "A chart mapping names a column the data does not have.", "The series cannot be built from a column that is not there.", { standard: SCHEMA }),
-  rule("number-format-invalid", "format", "error", "A number format cannot be read.", "A format code that no engine can parse is drawn as the plain number or fails to export.", { standard: "Excel number format codes, as far as OPF supports them" }),
-  rule("variable-invalid-value", "format", "error", "A variable value does not match its declared type.", "A number variable given text, or a date given a non-date, cannot be filled into the deck.", { standard: SCHEMA }),
-  rule("variable-unknown-builtin", "format", "error", "A token names a built-in variable that does not exist.", "The `deck.`, `speaker.`, `organization.` and `slide.` names (and `speakers`) are reserved for built-in variables; a name under them that is not a built-in can never be filled, so the token would show literally. The slide-scoped `slide.number`, `slide.section` and `deck.slideCount` are inline tokens only, so `var:slide.*` and `var:deck.slideCount` are reported too; organization logos are whole-field references only (`var:organization.logo.icon`), so a `{{organization.logo}}` token, an unknown logo shape or an unknown organization id is reported.", { standard: SCHEMA }),
-  rule("chart-highlight-unknown-name", "format", "error", "A chart highlight names a series or category the chart does not have.", "`chart.highlight` emphasises marks by name; a name that matches no series or category in the chart data highlights nothing, so the chart is not drawn as authored.", { standard: SCHEMA }),
-  rule("variable-format", "format", "error", "A variable cannot be formatted.", "A number or date format that does not apply to the value leaves the token unreadable.", { standard: SCHEMA }),
-  rule(
-    "variable-unfilled",
-    "format",
-    "error",
-    "A required template variable has no value.",
-    "A variable a deck declares as required, with no value, is template scaffolding: `{{name}}` tokens show up literally and colour variables fall back to a default. A normal deck must be filled, so this is an error and the deck is not valid; a template (`template: true`) is incomplete on purpose, so it is a warning.",
-    {
-      approximations: "Required variables are those the variable machinery reports as unfilled for the document (declared, no value, not `required: false`, not given by the `values` option). For a document that declares no content variables, `{{id}}` / `{{id|format}}` tokens (`{{` escapes) left in any string outside `variables`, `extensions`, `catalogs` and `assets` are reported as warnings. `var:` colour references with no declaration are reported as `opf/variable-reference-unknown`. Fill a template with `opf fill` or `resolveVariables` to clear the findings."
-    }
-  ),
-  rule("run-color-unrecognized", "format", "warning", "A text run colour is none of the documented forms.", "Run colours are open strings so imported decks stay valid, but a value that is not a hex colour, a colour-scheme name or a `var:` reference falls back to the theme colour.", { standard: SCHEMA }),
-  rule("numbering-start-ignored", "format", "warning", "A list entry sets `start` where nothing is numbered.", "A start value only restarts an auto-number; without `numbering` on the payload it has no effect.", { standard: SCHEMA }),
-  rule(
-    "slide-size-out-of-range",
-    "format",
-    "warning",
-    "The slide size is outside PowerPoint's 1 to 56 inch range.",
-    "The schema accepts any positive custom `widthInches` and `heightInches`, but a PPTX stores the size as `p:sldSz` with each side between 914400 and 51206400 EMU, which is 1 to 56 inches. A custom size outside that range exports a file that does not conform to the standard, which PowerPoint may reject or clamp. It is a warning because the document is still correct OPF and the preview draws it.",
-    {
-      standard: "ECMA-376 / ISO/IEC 29500-1 section 19.2.1.39 (p:sldSz) and section 19.7.17 (ST_SlideSizeCoordinate): 914400 to 51206400 EMU",
-      approximations: "Checks the deck's resolved size: `design.dimensions`, else the resolved theme's `dimensions`. Inches are converted to EMU as the PPTX exporter does (`Math.round(inches * 914400)`), so a side of exactly 1 in or 56 in passes. A slide-level theme with another size is `opf/slide-theme-dimensions`. Presets are always in range. PowerPoint's own behaviour at the limits was not measured."
-    }
-  )
-];
-var referenceRules = [
-  rule(
-    "asset-reference",
-    "references",
-    "error",
-    "An `asset:` reference names an asset that is not in the registry.",
-    "An image, logo or video that points at a missing asset cannot be drawn or exported. The check reads the document's own registry only; no file or URL is fetched.",
-    { standard: SCHEMA }
-  ),
-  rule("asset-cycle", "references", "error", "Asset references form a cycle.", "An asset whose source points back at itself never resolves to a file.", { standard: SCHEMA }),
-  rule(
-    "catalog-record",
-    "references",
-    "error",
-    "An embedded or registered catalog record is invalid.",
-    "A record that fails its companion schema cannot be resolved. Invalid records are left out of the lookup, so the references to them are reported too.",
-    { standard: "spec/schemas/<kind>.schema.json" }
-  ),
-  rule(
-    "layout-template",
-    "references",
-    "error",
-    "A layout template's region list is malformed.",
-    `A layout is one ordered list of regions, nested through splits for two dimensions. Engines cannot compose a list that is not 1 to 12 entries, an entry that is neither a region nor a split, a direction or size that is not valid, an "auto" size anywhere but in a column, splits nested more than three levels deep (the record's own list is level 1), or regions that compile to a grid larger than 12 x 12. composeSlide refuses such a record, so a slide that names it composes automatically.`,
-    { standard: "spec/schemas/layout.schema.json and the region list rules (docs/layout-templates.md)", approximations: "Checked on every layout record the document embeds and every registered record it uses, once the record passes its schema." }
-  ),
-  rule(
-    "layout-region",
-    "references",
-    "error",
-    "A layout template's regions are not valid.",
-    "Region names are unique across the whole record and may not be tag, auto or a promoted-region word (left, center, right, top, middle, bottom), so a Markdown block's region= stays unambiguous; title and subtitle name the heading regions, which take only a size; a subtitle region needs a title region; a region accepts at least one content kind; a region with flow 'none' holds one block; overflowRegion must name a body region. composeSlide refuses such a record.",
-    { standard: "spec/schemas/layout.schema.json and the region rules (docs/layout-templates.md)" }
-  ),
-  rule(
-    "unresolved-reference",
-    "references",
-    "warning",
-    "A content reference resolves nowhere.",
-    "A layout, theme, colour scheme, font scheme, narrative, audience, purpose or tone reference that neither the document embeds nor a registered catalog defines falls back: a slide composes automatically, a design uses the engine default. A strict export fails instead. A slide with no layout is automatic composition and is never reported.",
-    { standard: SCHEMA, approximations: "Resolved like every engine resolves it: catalogs.custom, then the records embedded under catalogs.default, then the catalog registered for its source (the first registered catalog when `default` is omitted); `name:id` in catalogs.<name>, then the catalog registered for its source. Nothing is fetched. Free-form audience and purpose text is not a reference." }
-  ),
-  rule(
-    "catalog-record-not-in-source",
-    "references",
-    "warning",
-    "A record embedded under a catalog group is not in that catalog.",
-    "A record under catalogs.default or a named group says it came from the catalog its source names. When the catalog the host registered for that source has no record of that kind and id, the record is the document's own and belongs in catalogs.custom, where an update from the catalog never looks for it. Rendering is unchanged: the embedded record still wins.",
-    { standard: SCHEMA, approximations: "Checked only against a catalog the host registered for the group's source (the first registered catalog for an omitted default.source); with none registered for it the check is silent. A record the catalog has with different content is an update difference (updateFromCatalog), not this finding. catalogs.custom is never checked." }
-  ),
-  rule("undeclared-catalog", "format", "error", "A reference names a catalog group the document does not declare.", "The prefix of a `name:id` reference names the group of `catalogs` it resolves in. A prefix with no group can never resolve, whatever the host registers, so it is a format error: engines reject the document at their format check instead of drawing a fallback.", { standard: SCHEMA }),
-  rule("unused-reference", "references", "warning", "A reference is never cited.", "A listed reference that no run cites is not drawn anywhere.", { standard: SCHEMA }),
-  rule("unused-dataset", "references", "warning", "A dataset is never used.", "A dataset no chart or table references is not drawn anywhere.", { standard: SCHEMA }),
-  rule("unknown-beat", "references", "warning", "A slide names a beat its narrative does not define.", "`slides[].beat` links a slide to a step of the narrative plan. A beat id the narrative does not have links to nothing; nothing is drawn from a beat.", { standard: SCHEMA, approximations: "The narrative resolves like every content reference: the document's catalogs groups, then the registered catalogs. A narrative that resolves nowhere is not checked." }),
-  rule("slide-theme-dimensions", "references", "warning", "A slide theme sets a slide size that differs from the deck.", "A PPTX has one slide size. The size a slide-level theme carries is never used: design.dimensions of the deck (or of its theme) wins in every engine, and without them the exporter stops with mixed slide sizes.", { standard: SCHEMA }),
-  rule("variable-unknown", "references", "warning", "A `{{token}}` names a variable that is not declared.", "An undeclared token is shown literally.", { standard: SCHEMA }),
-  rule("variable-unknown-value", "references", "warning", "A value was supplied for a variable that is not declared.", "The value is never used.", { standard: SCHEMA }),
-  rule("variable-unused", "references", "warning", "A variable is declared but never used.", "A declaration nothing refers to has no effect.", { standard: SCHEMA }),
-  rule("variable-reference-unknown", "references", "warning", "A `var:` colour names a variable that is not declared.", "An undeclared colour variable falls back to a default colour.", { standard: SCHEMA })
-];
-var policyRules = [
-  rule(
-    "contract",
-    "policy",
-    "error",
-    "A field is outside the values a host policy allows.",
-    "A host that needs brand layouts, fonts or other fixed choices states them as contracts. The default severity is error; a contract can set its own. Document metadata never installs policy.",
-    { approximations: "Only the `contracts` option supplies policy, and it checks existing fields: a contract does not require an omitted field or insert a default." }
-  )
-];
-var dataRules = [
-  rule("chart-option-adapted", "layout", "warning", "A chart option cannot be shown by the chart type.", "An axis title, legend or data label option the chart type does not support is adapted by every engine, so the chart is not drawn exactly as authored.", { standard: SCHEMA }),
-  rule(
-    "chart-value-not-numeric",
-    "content",
-    "warning",
-    "A chart value is text, not a number.",
-    'A chart plots numbers. A text cell such as "12%" is plotted as a gap. When every text value of a column is written in one display style the finding carries the fix that stores the numbers and gives the column the matching format.',
-    { standard: SCHEMA }
-  ),
-  rule("chart-mapping-adapted", "content", "warning", "A chart mapping entry is ignored.", "A mapping that names a column the chart type cannot use is left out of the chart.", { standard: SCHEMA }),
-  rule("chart-highlight-adapted", "content", "warning", "A chart highlight is adapted by the chart type.", "A highlight the chart type cannot show as authored (a category highlight on a chart without categories, for example) is adapted by every engine, so the emphasis is not exactly what was written.", { standard: SCHEMA }),
-  rule("code-highlight-out-of-range", "content", "warning", "A code highlight marks a line the code does not have.", "Marked lines count from 1 by line break in code.source; an entry past the last line marks nothing.", { standard: SCHEMA }),
-  rule("code-highlight-range-reversed", "content", "warning", "A code highlight range ends before it starts.", "A range written end before start marks nothing; write the smaller line number first.", { standard: SCHEMA }),
-  rule("variable-builtin-missing", "content", "warning", "A built-in variable has no value in this document.", "A `{{deck.*}}`, `{{speaker.*}}` or `{{organization.*}}` token whose field the document does not set resolves to nothing, so the text shows a gap; a `var:organization.logo` reference to an organization without a logo draws no image. `{{slide.section}}` is checked per slide: a slide without a `section` that uses it, in its own text or in the header or footer it inherits, is reported at that slide.", { standard: SCHEMA }),
-  rule("duration-outside-narrative", "content", "warning", "The target duration is outside the range the narrative suits.", "A narrative records the talk lengths it suits. A deck whose duration is outside that range probably needs a different narrative or a different length; nothing is drawn or exported differently.", { standard: SCHEMA }),
-  rule("narrative-duration-range", "content", "warning", "An inline narrative duration range has min greater than max.", "A range with its bounds swapped matches no duration, so the duration check cannot help.", { standard: "spec/schemas/narrative.schema.json" })
-];
-var implementations = [...accessibilityRules, ...layoutContentRules, ...languageTagRules];
-var ruleImplementations = implementations;
-var infos = [
-  ...formatRules,
-  ...referenceRules,
-  ...policyRules,
-  ...dataRules,
-  ...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 }))
-);
-var byName = /* @__PURE__ */ new Map();
-for (const info of validationRules) {
-  if (byName.has(info.id) || byName.has(info.name)) throw new Error(`Duplicate validation rule ${info.id}.`);
-  byName.set(info.id, info);
-  byName.set(info.name, info);
-}
-function findValidationRule(name) {
-  return byName.get(name);
-}
-function ruleInfo(id) {
-  const found = byName.get(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("/", "")}`;
-}
+var ruleImplementations = [...accessibilityRules, ...layoutContentRules, ...languageTagRules];
 
 // src/check-document.ts
 var own = (value, key2) => Object.hasOwn(value, key2);
@@ -5384,6 +5409,14 @@ function fieldLabel(segments) {
   }
   return code(last);
 }
+function placeWords(segments) {
+  if (!segments.length) return "at the top level";
+  const slide = segments[0] === "slides" && segments.length >= 2 && isIndex(segments[1]) ? Number(segments[1]) + 1 : void 0;
+  if (slide !== void 0 && segments.length === 2) return `in slide ${slide}`;
+  const last = segments[segments.length - 1];
+  const inner = isIndex(last) ? fieldLabel(segments) : code(last);
+  return slide !== void 0 ? `in ${inner} of slide ${slide}` : `in ${inner}`;
+}
 function containerName(segments) {
   if (!segments.length) return "the deck";
   if (segments.length === 2 && segments[0] === "slides" && isIndex(segments[1])) return "a slide";
@@ -6007,7 +6040,7 @@ var jsonSyntax = (finding2) => ({
 });
 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";
+  const owner = placeWords(helpers.segments.slice(0, -1));
   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."