@openpresentation/opf 0.9.0 → 0.10.1

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas--QRVBhU1.js';
-export { A as Audience, C as CatalogEntry, a as CatalogIndex, b as CatalogIndexRecord, c as CatalogKind, d as CatalogRecord, e as ChartType, f as ColorScheme, F as FontScheme, L as Language, g as Layout, N as Narrative, P as Purpose, S as SocialPlatform, T as Theme, h as Tone, 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';
+export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas-BYe5y8-i.js';
+export { A as Audience, C as CatalogEntry, a as CatalogIndex, b as CatalogIndexRecord, c as CatalogKind, d as CatalogRecord, e as ChartType, f as ColorScheme, F as FontScheme, L as Language, g as Layout, N as Narrative, P as Purpose, S as SocialPlatform, T as Theme, h as Tone, 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';
 export { OPFValidationError, ValidationIssue, ValidationResult, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './validator.js';
 export { SpecFileEntry, SpecFileKind, SpecFilePath, specFileEntries, specFileKinds, specFilePaths } from './spec-files.js';
 export { LayoutPreviewIndex, LayoutPreviewRecord, getLayoutPreview, hasLayoutPreview, layoutPreviewIndex, layoutPreviewSlugs, layoutPreviews } from './previews.js';
 export { P as Presentation } from './presentation-BMTdX6O1.js';
-export { CodeContent, CodeLayout, CodeLayoutDiagnostic, CodeLayoutOptions, CodeLineSegment, CodeLineSource, CodeTextFit, CodeTextPart, ComposeSlideOptions, ComposedFlow, ComposedGroup, ComposedItem, Composition, CompositionCandidate, CompositionDecision, CompositionExplanation, CompositionPenalties, CompositionTrack, FontFamilies, LayoutBox, LayoutDiagnostic, ListEntryLayout, ListFit, ListText, ListValue, MAX_COMPOSITION_DEPTH, MeasureTextWidth, OPFCompositionError, QuoteContent, QuoteLayout, QuoteLayoutDiagnostic, QuoteLayoutOptions, QuoteTextPart, QuoteTextSource, RichTextFit, RichTextFragment, RichTextLine, RichTextOptions, RichTextRun, SlideComposition, TextFit, TextMeasurement, TextStyle, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutQuote, measureText, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, textWidthMeasurer, wrapText } from './composition.js';
+export { LintContract, LintDiagnostic, LintLocation, LintOptions, LintReport, LintSeverity, LintSuggestion, lintPresentation, lintSource } from './lint.js';
+export { CodeContent, CodeLayout, CodeLayoutDiagnostic, CodeLayoutOptions, CodeLineSegment, CodeLineSource, CodeTextFit, CodeTextPart, ComposeSlideOptions, ComposedFlow, ComposedGroup, ComposedItem, Composition, CompositionCandidate, CompositionDecision, CompositionExplanation, CompositionPenalties, CompositionTrack, FontFamilies, FurnitureImagePart, FurnitureLayout, FurniturePart, FurniturePartBase, FurnitureTextPart, LayoutBox, LayoutDiagnostic, ListEntryLayout, ListFit, ListText, ListValue, MAX_COMPOSITION_DEPTH, MeasureTextWidth, MetricContent, MetricLayout, MetricLayoutDiagnostic, MetricLayoutOptions, MetricTextPart, MetricTextSource, OPFCompositionError, QuoteContent, QuoteLayout, QuoteLayoutDiagnostic, QuoteLayoutOptions, QuoteTextPart, QuoteTextSource, RichTextFit, RichTextFragment, RichTextLine, RichTextOptions, RichTextRun, SlideComposition, TextFit, TextLineInk, TextMeasurement, TextPlacement, TextPlacementLine, TextStyle, TimelineContent, TimelineEvent, TimelineLayout, TimelineLayoutDiagnostic, TimelineLayoutOptions, TimelineTextPart, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, textColorForFill, textWidthMeasurer, wrapText } from './composition.js';
 export { OPFPaginationError, PaginatedPage, PaginationMapping, PaginationOptions, PaginationResult, PresentationPaginationOptions, PresentationPaginationResult, paginatePresentation, paginateSlide } from './pagination.js';
 export { DataCell, DataContentOptions, DataImportOptions, OPFDataImportError, TabularData, createDataContent, parseTabularData } from './data.js';

package/dist/index.js

@@ -1,8 +1,9 @@
-export { specFileEntries, specFileKinds, specFilePaths } from './chunk-OZULJBSG.js';
+export { specFileEntries, specFileKinds, specFilePaths } from './chunk-RS5GZ5RW.js';
 export { getLayoutPreview, hasLayoutPreview, layoutPreviewIndex, layoutPreviewSlugs, layoutPreviews } from './chunk-PIQXLBBJ.js';
+export { lintPresentation, lintSource } from './chunk-EWJNRHXA.js';
 export { OPFDataImportError, createDataContent, parseTabularData } from './chunk-SOSOBKQ2.js';
-export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-3GPZMY2W.js';
-export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './chunk-ZGV6I23P.js';
-export { MAX_COMPOSITION_DEPTH, OPFCompositionError, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutQuote, measureText, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, textWidthMeasurer, wrapText } from './chunk-JA5W5TVA.js';
-export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-GQSK3T7X.js';
-export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-TWMRZ43O.js';
+export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-FHGJX5QK.js';
+export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './chunk-ZIL7MGZU.js';
+export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutFurniture, layoutMetric, layoutQuote, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, textColorForFill, textWidthMeasurer, wrapText } from './chunk-PQJRDNA6.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-D3GQIREP.js';
+export { audiences, catalogEntries, catalogIndexes, catalogKinds, catalogSchemaNames, catalogs, chartTypes, colorSchemes, fontSchemes, languages, layouts, narratives, purposes, socialPlatforms, themes, tones } from './chunk-TU7I3KSB.js';

package/dist/lint.d.ts

@@ -0,0 +1,70 @@
+import { c as CatalogKind } from './catalogs-DoVmvDr7.js';
+import { ValidationIssue } from './validator.js';
+import { J as JsonPrimitive } from './schemas-BYe5y8-i.js';
+import './presentation-BMTdX6O1.js';
+
+type LintSeverity = 'error' | 'warning' | 'info';
+interface LintLocation {
+    offset: number;
+    length: number;
+    line: number;
+    column: number;
+}
+interface LintSuggestion {
+    value: JsonPrimitive;
+    label: string;
+    origin: 'schema' | 'built-in' | 'loaded' | 'document' | 'contract';
+    definition: string;
+}
+interface LintDiagnostic {
+    ruleId: string;
+    severity: LintSeverity;
+    /** JSON Pointer into the document, or the explicitly supplied lint context. */
+    path: string;
+    scope: 'document' | 'context';
+    message: string;
+    help: string;
+    definition?: string;
+    lookup?: string[];
+    suggestions?: LintSuggestion[];
+    /** Full validation issue retained, including errors inside union alternatives. */
+    validation?: ValidationIssue;
+    /** Original-source UTF-16 offsets and one-based line/column. */
+    location?: LintLocation;
+}
+interface LintContract {
+    /** JSON Pointer pattern; a complete '*' segment matches one path segment. */
+    path: string;
+    allowedValues: JsonPrimitive[];
+    severity?: LintSeverity;
+    message?: string;
+    documentation?: string;
+}
+interface LintOptions {
+    /** Records already loaded by the host. This API never fetches catalog URLs. */
+    catalogs?: Partial<Record<CatalogKind, readonly unknown[]>>;
+    /** Explicit host policy. Document metadata is never interpreted as policy. */
+    contracts?: readonly LintContract[];
+}
+interface LintReport {
+    valid: boolean;
+    schemaValid: boolean | null;
+    diagnostics: LintDiagnostic[];
+    counts: Record<LintSeverity, number>;
+    checks: {
+        syntax: 'checked' | 'not-applicable';
+        schema: 'checked' | 'not-run';
+        catalogReferences: 'local-context' | 'not-run';
+        assetReferences: 'registry-only' | 'not-run';
+        contracts: 'checked' | 'not-run';
+        layout: 'not-checked';
+        fonts: 'not-checked';
+        nativeExport: 'not-checked';
+    };
+}
+/** Read-only lint with actionable schema, local catalog and explicit policy context. */
+declare function lintPresentation(document: unknown, options?: LintOptions): LintReport;
+/** Lint strict JSON source without normalizing whitespace or duplicate keys. */
+declare function lintSource(source: string, options?: LintOptions): LintReport;
+
+export { type LintContract, type LintDiagnostic, type LintLocation, type LintOptions, type LintReport, type LintSeverity, type LintSuggestion, lintPresentation, lintSource };

package/dist/lint.js

@@ -0,0 +1,5 @@
+export { lintPresentation, lintSource } from './chunk-EWJNRHXA.js';
+import './chunk-ZIL7MGZU.js';
+import './chunk-PQJRDNA6.js';
+import './chunk-D3GQIREP.js';
+import './chunk-TU7I3KSB.js';

package/dist/pagination.d.ts

@@ -21,6 +21,8 @@ interface PaginationMapping {
 interface PaginatedPage {
     slideIndex: number;
     mappings: PaginationMapping[];
+    /** Repeated headings/furniture and their metadata sources; separate from body slices. */
+    repeatedMappings?: PaginationMapping[];
 }
 interface PaginationResult {
     slides: Record<string, any>[];
@@ -35,6 +37,8 @@ declare class OPFPaginationError extends Error {
 declare function paginateSlide(input: unknown, options?: PaginationOptions): PaginationResult;
 interface PresentationPaginationOptions {
     textMeasurement?: TextMeasurement;
+    /** Unscaled reference-pixel clearance for supplied vector text outlines. */
+    textRasterPadding?: number;
     minFontSize?: number;
     maxSlides?: number;
     /** Optional host-resolved layout/canvas overrides for each source slide. */

package/dist/pagination.js

@@ -1,5 +1,5 @@
-export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-3GPZMY2W.js';
-import './chunk-ZGV6I23P.js';
-import './chunk-JA5W5TVA.js';
-import './chunk-GQSK3T7X.js';
-import './chunk-TWMRZ43O.js';
+export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-FHGJX5QK.js';
+import './chunk-ZIL7MGZU.js';
+import './chunk-PQJRDNA6.js';
+import './chunk-D3GQIREP.js';
+import './chunk-TU7I3KSB.js';

package/dist/{schemas--QRVBhU1.d.ts → schemas-BYe5y8-i.d.ts}

@@ -213,4 +213,4 @@ interface SchemaEntry {
 }
 declare const schemaEntries: readonly SchemaEntry[];
 
-export { type JsonSchema as J, type SchemaEntry as S, type SchemaName as a, audience as b, chartType as c, colorScheme as d, layout as e, fontScheme as f, purpose as g, schemaNames as h, schemas as i, socialPlatform as j, tone as k, language as l, narrative as n, presentation as p, schemaEntries as s, theme as t };
+export { type JsonPrimitive as J, type SchemaEntry as S, type SchemaName as a, audience as b, chartType as c, colorScheme as d, layout as e, fontScheme as f, purpose as g, schemaNames as h, schemas as i, socialPlatform as j, tone as k, language as l, type JsonSchema as m, narrative as n, presentation as p, schemaEntries as s, theme as t };

package/dist/schemas.d.ts

@@ -1 +1 @@
-export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas--QRVBhU1.js';
+export { S as SchemaEntry, a as SchemaName, b as audience, c as chartType, d as colorScheme, f as fontScheme, l as language, e as layout, n as narrative, p as presentation, g as purpose, s as schemaEntries, h as schemaNames, i as schemas, j as socialPlatform, t as theme, k as tone } from './schemas-BYe5y8-i.js';

package/dist/schemas.js

@@ -1 +1 @@
-export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-GQSK3T7X.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-D3GQIREP.js';

package/dist/spec/catalogs/layouts/extract/canonical.json

@@ -214,7 +214,7 @@
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ]
   },
@@ -226,10 +226,10 @@
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -244,13 +244,13 @@
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -265,16 +265,16 @@
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -290,19 +290,19 @@
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -318,22 +318,22 @@
         "type": "title"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       },
       {
-        "type": "text"
+        "type": "metric"
       }
     ],
     "composition": {
@@ -556,5 +556,29 @@
     "id": "blank",
     "name": "Blank",
     "placeholders": []
+  },
+  {
+    "id": "quote-1x",
+    "name": "Quote 1x",
+    "placeholders": [
+      {
+        "type": "title"
+      },
+      {
+        "type": "quote"
+      }
+    ]
+  },
+  {
+    "id": "timeline-1x",
+    "name": "Timeline 1x",
+    "placeholders": [
+      {
+        "type": "title"
+      },
+      {
+        "type": "timeline"
+      }
+    ]
   }
 ]

package/dist/spec/catalogs/layouts/index.json

@@ -113,6 +113,11 @@
       "name": "Number 6x",
       "file": "number-6x.json"
     },
+    {
+      "id": "quote-1x",
+      "name": "Quote 1x",
+      "file": "quote-1x.json"
+    },
     {
       "id": "table-1x",
       "name": "Table 1x",
@@ -133,6 +138,11 @@
       "name": "Text 3x",
       "file": "text-3x.json"
     },
+    {
+      "id": "timeline-1x",
+      "name": "Timeline 1x",
+      "file": "timeline-1x.json"
+    },
     {
       "id": "title",
       "name": "Title",

package/dist/spec/catalogs/layouts/number-1x.json

@@ -7,7 +7,7 @@
       "type": "title"
     },
     {
-      "type": "text"
+      "type": "metric"
     }
   ]
 }

package/dist/spec/catalogs/layouts/number-2x.json

@@ -7,10 +7,10 @@
       "type": "title"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     }
   ],
   "composition": {

package/dist/spec/catalogs/layouts/number-3x.json

@@ -7,13 +7,13 @@
       "type": "title"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     }
   ],
   "composition": {

package/dist/spec/catalogs/layouts/number-4x.json

@@ -7,16 +7,16 @@
       "type": "title"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     }
   ],
   "composition": {

package/dist/spec/catalogs/layouts/number-5x.json

@@ -7,19 +7,19 @@
       "type": "title"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     }
   ],
   "composition": {

package/dist/spec/catalogs/layouts/number-6x.json

@@ -7,22 +7,22 @@
       "type": "title"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     },
     {
-      "type": "text"
+      "type": "metric"
     }
   ],
   "composition": {

package/dist/spec/catalogs/layouts/quote-1x.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-layout/v1",
+  "id": "quote-1x",
+  "name": "Quote 1x",
+  "placeholders": [
+    {
+      "type": "title"
+    },
+    {
+      "type": "quote"
+    }
+  ]
+}

package/dist/spec/catalogs/layouts/timeline-1x.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://openpresentation.org/schema/opf-layout/v1",
+  "id": "timeline-1x",
+  "name": "Timeline 1x",
+  "placeholders": [
+    {
+      "type": "title"
+    },
+    {
+      "type": "timeline"
+    }
+  ]
+}

package/dist/spec/schemas/layout.schema.json

@@ -59,9 +59,15 @@
         "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",
@@ -267,6 +273,9 @@
             "subtitle",
             "tag",
             "text",
+            "metric",
+            "quote",
+            "timeline",
             "list",
             "chart",
             "picture",
@@ -275,7 +284,7 @@
             "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."
         }
       }
     },

package/dist/spec/schemas/narrative.schema.json

@@ -175,7 +175,7 @@
             "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",