@openpresentation/opf 0.9.0 → 0.10.1

package/README.md

@@ -22,7 +22,7 @@ pnpm add @openpresentation/opf
 # or: yarn add @openpresentation/opf
 ```
 
-Requires Node 20 or later.
+Requires Node 24 starting with version 0.10.0. Earlier published versions retain their recorded runtime requirements.
 
 ## Usage
 
@@ -69,6 +69,12 @@ import type { Presentation, Audience, Tone } from "@openpresentation/opf/types";
 
 The root entry exports every schema, catalog, and validation helper for convenience. Prefer the focused subpaths above when a package consumer only needs one surface, so the root bundle's full catalog/schema payload is not loaded unnecessarily.
 
+### Contextual lint (0.10.0)
+
+Version 0.10.0 adds `lintSource(source, options)` and `lintPresentation(document, options)` from `@openpresentation/opf/lint` and the root API. They report strict JSON syntax, duplicate keys, schema constraints, local catalog alternatives, asset registry errors, and explicit host contracts. Source diagnostics retain original UTF-16 ranges without rewriting the document. Options accept already loaded `catalogs` and `contracts`; no remote resources are fetched.
+
+Earlier versions do not include these APIs. See the [lint guide](../../docs/lint.md) for configuration and the source CLI. Passing lint does not certify layout, fonts, or native export fidelity.
+
 ### Layout previews
 
 `@openpresentation/opf/previews` ships pre-rendered HTML thumbnails for the

package/dist/{catalogs-BnnkUX9O.d.ts → catalogs-DoVmvDr7.d.ts}

@@ -1,4 +1,4 @@
-import { a as SchemaName } from './schemas--QRVBhU1.js';
+import { a as SchemaName } from './schemas-BYe5y8-i.js';
 
 /**
  * Schema for audience records in the pptx.gallery library. Each record names an audience archetype (e.g. 'executives', 'engineering-team', 'investors') and carries seniority, technical-fluency, decision-power, and attention-budget hints used by AI-driven generation. Audiences are referenced from OPF documents via audience; the engine resolves the reference against catalogs.audiences (inline) → catalogs.audiences.source → the default catalog at https://www.pptx.gallery/audiences. The audience field also accepts free-form strings; this catalog is for engine-aware audience archetypes that carry generation hints.
@@ -311,9 +311,9 @@ interface Layout {
      */
     description?: string;
     /**
-     * Primary kind of content the layout holds. Drives pickers and AI placement decisions.
+     * Primary kind of content the layout holds. Drives pickers and AI placement decisions. Metric is the canonical numeric/KPI category; Number remains an accepted legacy label.
      */
-    contentType?: ("Title" | "Text" | "List" | "Image" | "Number" | "Chart");
+    contentType?: ("Title" | "Text" | "List" | "Image" | "Number" | "Metric" | "Chart" | "Table" | "Code" | "Video" | "Quote" | "Timeline");
     /**
      * How many parallel content blocks the layout exposes ('2x' = two-column, '3x' = three-up, etc.).
      */
@@ -407,9 +407,9 @@ interface Layout {
  */
 interface Placeholder {
     /**
-     * OPF placeholder kind. 'text' and 'list' are flexible textual content regions. The named kinds describe a specific content role used by pickers, AI generation, and engine defaulting.
+     * OPF placeholder kind. 'text' and 'list' are flexible textual content regions. 'metric' is a numeric/KPI content region filled by a metric payload, including its optional label, description, unit, delta, and trend. The named kinds describe a specific content role used by pickers, AI generation, and engine defaulting. 'picture' and legacy 'diagram' use image payloads; 'media' uses video. Quote and timeline use their corresponding payload fields.
      */
-    type: ("title" | "subtitle" | "tag" | "text" | "list" | "chart" | "picture" | "table" | "media" | "diagram" | "code");
+    type: ("title" | "subtitle" | "tag" | "text" | "metric" | "quote" | "timeline" | "list" | "chart" | "picture" | "table" | "media" | "diagram" | "code");
     [k: string]: unknown;
 }
 /**
@@ -789,7 +789,7 @@ interface Beat {
      */
     slideCount?: number;
     /**
-     * Default content kind for the beat's slide. Mirrors ContentPayload.type and helps engines choose a sensible layout when only the beat is specified.
+     * Default content kind for the beat's slide. Uses ContentPayload.type names to help engines choose a layout. The legacy shape value is retained for compatibility and requests an image representation; it is not a native ContentPayload type.
      */
     slideType?: ("text" | "list" | "image" | "shape" | "chart" | "table" | "video" | "code" | "metric" | "quote" | "timeline");
     /**

package/dist/catalogs.d.ts

@@ -1,2 +1,2 @@
-export { C as CatalogEntry, a as CatalogIndex, b as CatalogIndexRecord, c as CatalogKind, d as CatalogRecord, i as audiences, j as catalogEntries, k as catalogIndexes, l as catalogKinds, m as catalogSchemaNames, n as catalogs, o as chartTypes, p as colorSchemes, q as fontSchemes, r as languages, s as layouts, t as narratives, u as purposes, v as socialPlatforms, w as themes, x as tones } from './catalogs-BnnkUX9O.js';
-import './schemas--QRVBhU1.js';
+export { C as CatalogEntry, a as CatalogIndex, b as CatalogIndexRecord, c as CatalogKind, d as CatalogRecord, i as audiences, j as catalogEntries, k as catalogIndexes, l as catalogKinds, m as catalogSchemaNames, n as catalogs, o as chartTypes, p as colorSchemes, q as fontSchemes, r as languages, s as layouts, t as narratives, u as purposes, v as socialPlatforms, w as themes, x as tones } from './catalogs-DoVmvDr7.js';
+import './schemas-BYe5y8-i.js';

package/dist/catalogs.js

@@ -1 +1 @@
-export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-TWMRZ43O.js';
+export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-TU7I3KSB.js';

package/dist/{chunk-GQSK3T7X.js → chunk-D3GQIREP.js}

@@ -4873,9 +4873,15 @@ var layout = {
         "List",
         "Image",
         "Number",
-        "Chart"
+        "Metric",
+        "Chart",
+        "Table",
+        "Code",
+        "Video",
+        "Quote",
+        "Timeline"
       ],
-      "description": "Primary kind of content the layout holds. Drives pickers and AI placement decisions."
+      "description": "Primary kind of content the layout holds. Drives pickers and AI placement decisions. Metric is the canonical numeric/KPI category; Number remains an accepted legacy label."
     },
     "contentMultiple": {
       "type": "string",
@@ -5083,6 +5089,9 @@ var layout = {
             "subtitle",
             "tag",
             "text",
+            "metric",
+            "quote",
+            "timeline",
             "list",
             "chart",
             "picture",
@@ -5091,7 +5100,7 @@ var layout = {
             "diagram",
             "code"
           ],
-          "description": "OPF placeholder kind. 'text' and 'list' are flexible textual content regions. The named kinds describe a specific content role used by pickers, AI generation, and engine defaulting."
+          "description": "OPF placeholder kind. 'text' and 'list' are flexible textual content regions. 'metric' is a numeric/KPI content region filled by a metric payload, including its optional label, description, unit, delta, and trend. The named kinds describe a specific content role used by pickers, AI generation, and engine defaulting. 'picture' and legacy 'diagram' use image payloads; 'media' uses video. Quote and timeline use their corresponding payload fields."
         }
       }
     },
@@ -5871,7 +5880,7 @@ var narrative = {
             "quote",
             "timeline"
           ],
-          "description": "Default content kind for the beat's slide. Mirrors ContentPayload.type and helps engines choose a sensible layout when only the beat is specified."
+          "description": "Default content kind for the beat's slide. Uses ContentPayload.type names to help engines choose a layout. The legacy shape value is retained for compatibility and requests an image representation; it is not a native ContentPayload type."
         },
         "layoutHint": {
           "type": "string",