@openpresentation/opf 0.12.2 → 0.13.0

package/dist/{chunk-4LAM3N6S.js → chunk-7QBCWNWL.js}

@@ -358,6 +358,10 @@ Deck-level concerns that aren't part of the storyline (audience, tone, takeaway,
         ]
       ]
     },
+    "datasets": {
+      "$ref": "#/$defs/Datasets",
+      "description": `Optional shared data tables, keyed by id. A chart ('chart.data': { "dataset": "<id>" }) or a table ('table': { "dataset": "<id>" }) references one instead of holding its own copy; engines inline the reference before composing, rendering or exporting. A dataset nothing references is a lint warning (opf/unused-dataset). See docs/chart-table-data.md.`
+    },
     "assets": {
       "$ref": "#/$defs/Assets",
       "description": "Optional reusable asset registry for images, data files, videos, documents, fonts, and other resources referenced elsewhere in the deck via 'asset:<id>' strings."
@@ -2466,19 +2470,25 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
           "description": "Illustrative number shown in fill forms and used when a template is previewed with examples. Never written to output."
         },
         "format": {
-          "type": "string",
-          "description": "Display pattern used by '{{<id>}}'. A literal prefix, a numeric part of '#', '0', ',' and '.', and a literal suffix. '0' pads digits, '#' is optional, ',' groups thousands, digits after '.' fix the decimals ('0' required, '#' optional), and a '%' in the suffix scales by 100. English separators only. Absent: the shortest decimal form.",
-          "examples": [
-            "#,##0",
-            "0.0",
-            "$#,##0.00",
-            "0.#%",
-            "#,##0.0M"
-          ]
+          "$ref": "#/$defs/NumberFormat",
+          "description": "Display pattern used by '{{<id>}}' (the shared NumberFormat syntax). A literal prefix, a numeric part of '#', '0', ',' and '.', and a literal suffix. '0' pads digits, '#' is optional, ',' groups thousands, digits after '.' fix the decimals ('0' required, '#' optional), and a '%' in the suffix scales by 100. English separators only. Absent: the shortest decimal form."
         }
       },
       "description": "A number. '{{<id>}}' inserts it as text using 'format'; 'var:<id>' as a whole field supplies the number itself (chart values, font sizes)."
     },
+    "NumberFormat": {
+      "type": "string",
+      "description": "Number display pattern, shared by NumberVariable.format, data column formats (DataColumn.format) and table cell formats (StyledTableCell.format). An optional literal prefix, a numeric part of '#', '0', ',' and '.', and an optional literal suffix. '0' pads digits, '#' is optional, ',' groups thousands, digits after '.' fix the decimals ('0' required, '#' optional), and a '%' in the prefix or suffix multiplies the value by 100. English separators only. A format applies only to number values; strings, booleans, null and rich runs display unchanged. A column or cell format that is not a valid pattern is a 'number-format-invalid' error. The PPTX export writes it as the equivalent Excel number format code.",
+      "examples": [
+        "#,##0",
+        "0.0",
+        "$#,##0.00",
+        "0.#%",
+        "0%",
+        "#,##0.0M",
+        "#,##0 units"
+      ]
+    },
     "DateVariable": {
       "type": "object",
       "required": [
@@ -4645,9 +4655,16 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
             },
             {
               "$ref": "#/$defs/ChartDataSource"
+            },
+            {
+              "$ref": "#/$defs/DatasetRef"
             }
           ],
-          "description": "Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally."
+          "description": `Chart data. Inline data uses a tabular columns/rows shape; renderers convert rows to chart series internally. A DatasetRef ({ "dataset": "<id>" }) plots a top-level dataset instead. A ChartDataSource is not resolved by any engine (a 'chart-data-source-unresolved' warning; engines draw a placeholder); prefer inline data with a 'source'.`
+        },
+        "mapping": {
+          "$ref": "#/$defs/ChartMapping",
+          "description": "Optional series mapping by column name: which column is the category, which is the X column of a scatter chart, and which columns are plotted, in order. Absent keeps the positional rule (first column the category, then the X column for scatter, every other column a series)."
         },
         "axisTitles": {
           "$ref": "#/$defs/ChartAxisTitles",
@@ -4746,11 +4763,27 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
     },
     "Table": {
       "type": "object",
-      "description": "Table content. Columns are optional; rows are the only required field.",
+      "description": "Table content, inline or dataset-backed. An inline table has 'rows' (required) and optional 'columns'. A dataset-backed table has 'dataset' (required) and optional 'fields', and no 'rows' or 'columns': it takes its headers, rows and column formats from the dataset (per-cell styles need an inline table).",
       "additionalProperties": false,
-      "required": [
-        "rows"
-      ],
+      "if": {
+        "required": [
+          "dataset"
+        ]
+      },
+      "then": {
+        "properties": {
+          "rows": false,
+          "columns": false
+        }
+      },
+      "else": {
+        "required": [
+          "rows"
+        ],
+        "properties": {
+          "fields": false
+        }
+      },
       "properties": {
         "columns": {
           "type": "array",
@@ -4768,12 +4801,15 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
               {
                 "$ref": "#/$defs/StyledTableCell"
               },
+              {
+                "$ref": "#/$defs/DataColumn"
+              },
               {
                 "type": "null"
               }
             ]
           },
-          "description": "Optional column labels. Labels may be strings, rich runs or styled cell objects. Null is an empty label or a placeholder covered by a preceding column span.",
+          "description": `Optional column labels. Labels may be strings, rich runs, styled cell objects or DataColumn objects ({ "name", "format" }). A header's 'format' (DataColumn or StyledTableCell) is the column's number format; a body cell's own format wins. Null is an empty label or a placeholder covered by a preceding column span.`,
           "examples": [
             [
               "Region",
@@ -4808,12 +4844,20 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
               ]
             ]
           ]
+        },
+        "dataset": {
+          "$ref": "#/$defs/DatasetId",
+          "description": "Id of a top-level dataset that supplies this table's headers, rows and column formats. Excludes 'rows' and 'columns'. An unknown id is a 'dataset-unknown' error."
+        },
+        "fields": {
+          "$ref": "#/$defs/DatasetFields",
+          "description": "Dataset tables only: the dataset columns to show, by name and in order. Absent shows every column. An unknown name is a 'dataset-field-unknown' error."
         }
       }
     },
     "ChartData": {
       "type": "object",
-      "description": "Inline tabular data driving a chart. The first column usually supplies category/x-axis labels; subsequent columns are plotted measures unless a chart type or renderer maps them differently.",
+      "description": "Inline tabular data driving a chart. The first column usually supplies category/x-axis labels; subsequent columns are plotted measures unless 'chart.mapping' or a chart type maps them differently. Value cells are numbers; a string is read only in strict decimal syntax ('12', '-3.5', '1e6'), and anything else ('12%', '$5', '(5)', '1,234') is a gap and a 'chart-value-not-numeric' warning.",
       "additionalProperties": false,
       "required": [
         "columns",
@@ -4823,10 +4867,17 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
         "columns": {
           "type": "array",
           "items": {
-            "type": "string"
+            "oneOf": [
+              {
+                "type": "string"
+              },
+              {
+                "$ref": "#/$defs/DataColumn"
+              }
+            ]
           },
           "minItems": 1,
-          "description": "Ordered column labels for the chart data table.",
+          "description": 'Ordered column labels for the chart data table. A label is a string or a DataColumn ({ "name", "format" }) whose number format the data labels, value axis and exported workbook use.',
           "examples": [
             [
               "Quarter",
@@ -4836,6 +4887,17 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
               "Quarter",
               "Revenue",
               "Costs"
+            ],
+            [
+              "Quarter",
+              {
+                "name": "Revenue",
+                "format": "$#,##0.0"
+              },
+              {
+                "name": "Margin",
+                "format": "0%"
+              }
             ]
           ]
         },
@@ -4869,9 +4931,349 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
               ]
             ]
           ]
+        },
+        "source": {
+          "$ref": "#/$defs/DataSourceRef",
+          "description": "Optional provenance: where this inline data came from. Engines never read, fetch or refresh it; they keep it through editing, export and re-import."
+        }
+      }
+    },
+    "DataColumn": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name"
+      ],
+      "description": 'A named data column with an optional number format. Anywhere a chart or dataset column is a string it may be a DataColumn; the string form is { "name": value } with no format. A table column header may also be a DataColumn.',
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Column label, used as the series name, the table header and the name 'fields' and 'chart.mapping' address.",
+          "examples": [
+            "Revenue",
+            "Margin"
+          ]
+        },
+        "format": {
+          "$ref": "#/$defs/NumberFormat",
+          "description": "Number format of the column's number values (data labels, value axis, table cells, exported workbook). Absent: the General form."
+        }
+      },
+      "examples": [
+        {
+          "name": "Revenue",
+          "format": "$#,##0.0"
+        },
+        {
+          "name": "Margin",
+          "format": "0%"
+        }
+      ]
+    },
+    "DataSourceRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "src"
+      ],
+      "description": "Provenance of inline data or a dataset: the file, sheet and range it came from and when. Engines never read, fetch or refresh it; they keep it through editing, export and re-import. Re-import the data to update it.",
+      "properties": {
+        "src": {
+          "type": "string",
+          "description": "Where the data came from: an 'asset:<id>' reference, a URL, or a relative or local path.",
+          "examples": [
+            "./data/revenue.csv",
+            "asset:revenue",
+            "https://cdn.acme.com/data/revenue.csv"
+          ]
+        },
+        "sheet": {
+          "type": "string",
+          "description": "Sheet or table name inside a spreadsheet source.",
+          "examples": [
+            "Sheet1"
+          ]
+        },
+        "range": {
+          "type": "string",
+          "description": "A1-style range inside a spreadsheet source.",
+          "examples": [
+            "A1:D8"
+          ]
+        },
+        "fields": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "The source fields the data was taken from, in order.",
+          "examples": [
+            [
+              "Quarter",
+              "Revenue"
+            ]
+          ]
+        },
+        "retrieved": {
+          "type": "string",
+          "anyOf": [
+            {
+              "format": "date"
+            },
+            {
+              "format": "date-time"
+            }
+          ],
+          "description": "When the data was taken from the source: an ISO 8601 date or date-time.",
+          "examples": [
+            "2026-10-05",
+            "2026-10-05T09:30:00Z"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "description": "Free-form note about the source.",
+          "examples": [
+            "Finance export, unaudited"
+          ]
+        }
+      },
+      "examples": [
+        {
+          "src": "./data/revenue.csv",
+          "retrieved": "2026-10-05"
+        }
+      ]
+    },
+    "DatasetId": {
+      "type": "string",
+      "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$",
+      "description": "Id of an entry in the top-level datasets map (the assets id pattern).",
+      "examples": [
+        "revenue",
+        "pipeline-2026"
+      ]
+    },
+    "DatasetFields": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      },
+      "minItems": 1,
+      "uniqueItems": true,
+      "description": "Dataset column names to use, in order, each at most once. Selects and orders the dataset's columns; an unknown name is a 'dataset-field-unknown' error.",
+      "examples": [
+        [
+          "Quarter",
+          "Revenue"
+        ]
+      ]
+    },
+    "Datasets": {
+      "type": "object",
+      "description": `Shared data tables keyed by id (the assets id pattern). Charts reference one with 'chart.data': { "dataset": "<id>" } and tables with 'table': { "dataset": "<id>" }.`,
+      "propertyNames": {
+        "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/Dataset"
+      },
+      "examples": [
+        {
+          "revenue": {
+            "title": "Revenue by quarter",
+            "columns": [
+              "Quarter",
+              {
+                "name": "Revenue",
+                "format": "$#,##0.0"
+              },
+              "Costs"
+            ],
+            "rows": [
+              [
+                "Q1",
+                12,
+                8
+              ],
+              [
+                "Q2",
+                18,
+                11
+              ],
+              [
+                "Q3",
+                24,
+                15
+              ]
+            ],
+            "source": {
+              "src": "./data/revenue.csv",
+              "retrieved": "2026-10-05"
+            }
+          }
+        }
+      ]
+    },
+    "Dataset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "columns",
+        "rows"
+      ],
+      "description": "One shared data table: named columns (strings or DataColumn objects with a number format) and rows of scalar cells. Column names are unique ('data-column-duplicate' error). Rich text and styling belong in an inline table.",
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Human name of the dataset, shown by editors.",
+          "examples": [
+            "Revenue by quarter"
+          ]
+        },
+        "description": {
+          "type": "string",
+          "description": "What the dataset holds.",
+          "examples": [
+            "Quarterly revenue and costs, in $M."
+          ]
+        },
+        "columns": {
+          "type": "array",
+          "items": {
+            "oneOf": [
+              {
+                "type": "string"
+              },
+              {
+                "$ref": "#/$defs/DataColumn"
+              }
+            ]
+          },
+          "minItems": 1,
+          "description": "Ordered, uniquely named columns.",
+          "examples": [
+            [
+              "Quarter",
+              {
+                "name": "Revenue",
+                "format": "$#,##0.0"
+              },
+              "Costs"
+            ]
+          ]
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": {
+              "$ref": "#/$defs/ChartDataCell"
+            }
+          },
+          "description": "Rows of scalar cells (string, number, boolean, null); each row aligns by index with columns.",
+          "examples": [
+            [
+              [
+                "Q1",
+                12,
+                8
+              ],
+              [
+                "Q2",
+                18,
+                11
+              ]
+            ]
+          ]
+        },
+        "source": {
+          "$ref": "#/$defs/DataSourceRef",
+          "description": "Optional provenance. Engines never read, fetch or refresh it."
         }
       }
     },
+    "DatasetRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "dataset"
+      ],
+      "description": "Chart data taken from a top-level dataset. Engines inline it before plotting; 'chart.mapping' names columns after the 'fields' selection.",
+      "properties": {
+        "dataset": {
+          "$ref": "#/$defs/DatasetId",
+          "description": "Id of the dataset. An unknown id is a 'dataset-unknown' error."
+        },
+        "fields": {
+          "$ref": "#/$defs/DatasetFields",
+          "description": "The dataset columns to use, by name and in order. Absent uses every column."
+        }
+      },
+      "examples": [
+        {
+          "dataset": "revenue"
+        },
+        {
+          "dataset": "revenue",
+          "fields": [
+            "Quarter",
+            "Revenue"
+          ]
+        }
+      ]
+    },
+    "ChartMapping": {
+      "type": "object",
+      "additionalProperties": false,
+      "description": "Series mapping by column name (after any 'fields' selection). Mapping only selects and orders columns; pie, doughnut and other single-series constructs still plot one series. An unknown name is a 'chart-mapping-unknown-column' error; a series that repeats the category or X column, and an X column on a chart type without an X axis, are dropped with a 'chart-mapping-adapted' warning.",
+      "properties": {
+        "category": {
+          "type": "string",
+          "description": "The label (category) column. Default: the first column.",
+          "examples": [
+            "Quarter"
+          ]
+        },
+        "x": {
+          "type": "string",
+          "description": "The X column of an XY (scatter) chart. Default: the second column (the first, when the category is the second column), and only when there are three or more columns: with two, the second column is the one series, plotted against row numbers. An X that leaves no series is plotted as the series with a 'chart-mapping-adapted' warning.",
+          "examples": [
+            "Spend"
+          ]
+        },
+        "series": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "description": "The plotted columns, in order. Default: every column that is not the category or the X column.",
+          "examples": [
+            [
+              "Revenue",
+              "Costs"
+            ]
+          ]
+        }
+      },
+      "examples": [
+        {
+          "category": "Quarter",
+          "series": [
+            "Costs",
+            "Revenue"
+          ]
+        },
+        {
+          "category": "Region",
+          "x": "Spend",
+          "series": [
+            "Revenue"
+          ]
+        }
+      ]
+    },
     "ChartDataSource": {
       "type": "object",
       "description": "Chart data sourced from an asset reference, URL, data URI, relative path, or local path such as CSV, TSV, JSON, or XLSX. The source is interpreted as a table; optional columns select or order fields from that table.",
@@ -5000,6 +5402,10 @@ Resolution order: inline catalogs.fontSchemes.records[] -> catalogs.fontSchemes.
           "type": "integer",
           "minimum": 1,
           "description": "Number of grid rows covered, starting at this cell. Covered positions must contain null. Header cells cannot span into body rows. Default 1."
+        },
+        "format": {
+          "$ref": "#/$defs/NumberFormat",
+          "description": "Number format. On a body cell it formats that cell's number value (and wins over the column's format); on a header cell (in 'columns') it is the column's format, the same as a DataColumn header. Strings, booleans, null and rich runs display unchanged."
         }
       },
       "description": "A cell with explicit visual style or merged geometry. Its position remains its array column index; use null placeholders for every covered grid position."

package/dist/{chunk-SOSOBKQ2.js → chunk-ATGDDJPX.js}

@@ -1,3 +1,5 @@
+import { chartNumber } from './chunk-MPM7NRG7.js';
+
 // src/data.ts
 var OPFDataImportError = class extends Error {
   constructor(message) {
@@ -108,11 +110,8 @@ function parseTabularData(input, options = {}) {
   return data;
 }
 function measure(value, location) {
-  if (typeof value === "number" && Number.isFinite(value)) return value;
-  if (typeof value === "string" && /^-?(?:0|[1-9]\d*)(?:\.\d+)?(?:[eE][+-]?\d+)?$/.test(value.trim())) {
-    const number = Number(value.trim());
-    if (Number.isFinite(number) && (!Number.isInteger(number) || Number.isSafeInteger(number))) return number;
-  }
+  const number = chartNumber(value);
+  if (number !== null) return number;
   return fail(`${location}: expected a numeric chart value; found ${JSON.stringify(value)}. Clean the value or select another series.`);
 }
 function createDataContent(input, options) {

package/dist/{chunk-V2537ENL.js → chunk-II5EYKZU.js}

@@ -1,4 +1,4 @@
-import { validatePresentation } from './chunk-JKVKYVWL.js';
+import { validatePresentation } from './chunk-IYCJUKWD.js';
 
 // src/convert/shared.ts
 var CONTENT_KEYS = ["text", "items", "bullets", "image", "video", "chart", "table", "code", "metric", "quote", "timeline"];
@@ -35,15 +35,17 @@ function canonical(value) {
 }
 var isSlideLike = (payload) => SLIDE_ONLY_KEYS.some((key) => own(payload, key));
 var contentKeysOf = (payload) => CONTENT_KEYS.filter((key) => payload[key] !== void 0);
-function assertValidOutput(value, as = "block") {
+function assertValidOutput(value, as = "block", context = {}) {
   const slides = as === "slides" ? value : as === "slide" ? [value] : [{ blocks: [value] }];
-  const result = validatePresentation({ slides });
-  if (!result.valid) {
-    const first = result.errors[0];
-    throw new OPFConversionError("invalid-output", `The converted content is not valid OPF: ${first?.message ?? "unknown error"}${first?.path ? ` (${first.path})` : ""}.`, { issues: result.errors });
+  const datasets = isRecord(context.datasets) ? context.datasets : void 0;
+  const result = validatePresentation({ ...datasets ? { datasets } : {}, slides });
+  const errors = datasets ? result.errors : result.errors.filter((issue) => issue.params.code !== "dataset-unknown" && issue.params.code !== "dataset-field-unknown");
+  if (errors.length) {
+    const first = errors[0];
+    throw new OPFConversionError("invalid-output", `The converted content is not valid OPF: ${first?.message ?? "unknown error"}${first?.path ? ` (${first.path})` : ""}.`, { issues: errors });
   }
 }
-var assertValidOwner = (owner) => assertValidOutput(owner, isSlideLike(owner) ? "slide" : "block");
+var assertValidOwner = (owner, context = {}) => assertValidOutput(owner, isSlideLike(owner) ? "slide" : "block", context);
 var FORMATTING = ["bold", "italic", "underline", "strikethrough", "color", "fontSize", "fontFamily", "link", "superscript", "subscript"];
 var isPlainRun = (run) => typeof run === "string" || isRecord(run) && !FORMATTING.some((key) => run[key] !== void 0);
 var runText = (run) => typeof run === "string" ? run : run.text ?? "";

package/dist/{chunk-MWPMJE6P.js → chunk-INU7ZNSB.js}

@@ -1,8 +1,10 @@
-import { validatePresentation, unusedReferenceWarnings, validationDefinition, validateCatalogRecord } from './chunk-JKVKYVWL.js';
+import { validatePresentation, unusedReferenceWarnings, validationDefinition, validateCatalogRecord } from './chunk-IYCJUKWD.js';
+import { unusedDatasets, isRecord, visitContentPayloads, chartNumberFixesByCell, pathFor } from './chunk-MPM7NRG7.js';
 import { catalogKinds, catalogEntries, catalogSchemaNames } from './chunk-E34DJ5LL.js';
-import { schemas, schemaEntries } from './chunk-4LAM3N6S.js';
+import { schemas, schemaEntries } from './chunk-7QBCWNWL.js';
 import { parseTree, printParseErrorCode, getNodePath } from 'jsonc-parser';
 
+var DATA_WARNING_CODES = /* @__PURE__ */ new Set(["chart-value-not-numeric", "chart-data-source-unresolved", "chart-mapping-adapted"]);
 var own = (value, key) => Object.hasOwn(value, key);
 var object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 var primitive = (value) => value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number" && Number.isFinite(value);
@@ -365,6 +367,20 @@ function distance(a, b) {
   }
   return row[b.length] ?? Math.max(a.length, b.length);
 }
+function chartNumberFixPaths(document) {
+  const byCell = /* @__PURE__ */ new Map();
+  if (!isRecord(document) || !Array.isArray(document.slides)) return byCell;
+  const payload = (node, path) => {
+    if (isRecord(node.chart))
+      for (const [cell, fix] of chartNumberFixesByCell(node.chart, document, { path: pathFor(path, "chart") })) byCell.set(cell, fix);
+  };
+  document.slides.forEach((slide, index) => {
+    if (!isRecord(slide)) return;
+    payload(slide, `/slides/${index}`);
+    visitContentPayloads(slide, `/slides/${index}`, payload);
+  });
+  return byCell;
+}
 function lintPresentation(document, options = {}) {
   optionsChecked(options);
   const validation = validatePresentation(document), diagnostics = validation.errors.map(
@@ -448,7 +464,28 @@ function lintPresentation(document, options = {}) {
       current = typeof source === "string" && source.startsWith("asset:") ? source.slice(6) : void 0;
     }
   }
+  const numberFixes = validation.warnings.some((issue) => issue.params.code === "chart-value-not-numeric") ? chartNumberFixPaths(document) : /* @__PURE__ */ new Map();
   for (const issue of validation.warnings) {
+    if (typeof issue.params.code === "string" && DATA_WARNING_CODES.has(issue.params.code)) {
+      const fix = issue.params.code === "chart-value-not-numeric" ? numberFixes.get(issue.path) : void 0;
+      if (fix) {
+        diagnostics.push({
+          ...schemaDiagnostic(issue),
+          ruleId: "opf/chart-value-not-numeric",
+          severity: "warning",
+          help: `Every text value of column ${JSON.stringify(fix.name)} is written in one display style. Store the numbers and give the column the format ${JSON.stringify(fix.format)}, which shows the same text: apply fixes[0] (core suggestChartNumberFix). Until then the value is plotted as a gap.`,
+          fixes: [{ id: "store-chart-numbers", label: `Store ${JSON.stringify(fix.name)} as numbers with the format ${JSON.stringify(fix.format)}`, kind: "patch", safe: false, patch: fix.patches }]
+        });
+        continue;
+      }
+      diagnostics.push({
+        ...schemaDiagnostic(issue),
+        ruleId: `opf/${issue.params.code}`,
+        severity: "warning",
+        help: issue.params.code === "chart-value-not-numeric" ? 'Write chart values as numbers (or strict decimal strings such as "12.5" or "1e6"); put currency, percent and units in the column format ({ "name": "Revenue", "format": "$#,##0" }). The value is plotted as a gap.' : issue.params.code === "chart-data-source-unresolved" ? "No engine loads chart data sources. Import the data inline (columns and rows, recording the origin in data.source) or reference a top-level dataset." : "The mapping entry is ignored. Remove it, or name a different column."
+      });
+      continue;
+    }
     const kind = issue.params.kind, id = issue.params.id, replacedBy = issue.params.replacedBy;
     if (typeof replacedBy === "string" && typeof id === "string") {
       const target = catalogs.get(kind)?.get(replacedBy);
@@ -529,6 +566,17 @@ function lintPresentation(document, options = {}) {
       lookup: ["opf", "schema", "presentation", "/$defs/Reference"],
       validation: issue
     });
+  for (const id of unusedDatasets(document))
+    diagnostics.push({
+      ruleId: "opf/unused-dataset",
+      severity: "warning",
+      scope: "document",
+      path: `/datasets/${id.replaceAll("~", "~0").replaceAll("/", "~1")}`,
+      message: `Dataset ${JSON.stringify(id)} is never referenced; reference it from a chart ("data": { "dataset": ${JSON.stringify(id)} }) or a table ({ "dataset": ${JSON.stringify(id)} }), or remove it.`,
+      help: "Reference the dataset from chart.data or a table so it is drawn, or remove the entry. Nothing is drawn for an unreferenced dataset.",
+      definition: schemas.presentation.$id + "#/$defs/Dataset",
+      lookup: ["opf", "schema", "presentation", "/$defs/Dataset"]
+    });
   return report(diagnostics, validation.valid, "not-applicable");
 }
 function lintSource(source, options = {}) {

package/dist/{chunk-RUC7L5DJ.js → chunk-IS2CPNVJ.js}

@@ -1,4 +1,4 @@
-import { validatePresentation } from './chunk-JKVKYVWL.js';
+import { validatePresentation } from './chunk-IYCJUKWD.js';
 
 // src/patch.ts
 var PatchError = class extends Error {