@openpresentation/opf 0.8.0 → 0.10.0

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-HCTav5Wv.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 { 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, 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, 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, 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 { getLayoutPreview, hasLayoutPreview, layoutPreviewIndex, layoutPreviewSlugs, layoutPreviews } from './chunk-PIQXLBBJ.js';
+export { lintPresentation, lintSource } from './chunk-NPOKUFEX.js';
 export { OPFDataImportError, createDataContent, parseTabularData } from './chunk-SOSOBKQ2.js';
-export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-X22DFHMW.js';
-export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './chunk-HIY26FJV.js';
-export { MAX_COMPOSITION_DEPTH, OPFCompositionError, composeSlide, fitList, fitRichText, fitText, layoutQuote, measureText, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, textWidthMeasurer, wrapText } from './chunk-NEQAPMS2.js';
+export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-TK3QHM3U.js';
+export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './chunk-GCB6LGJM.js';
+export { MAX_COMPOSITION_DEPTH, OPFCompositionError, chartColorForFill, colorContrast, composeSlide, fitList, fitRichText, fitText, layoutCode, layoutMetric, layoutQuote, layoutTimeline, measureText, measureTextOutline, placeTextLines, resolveCanvasDimensions, resolveFontFamilies, resolveTextStyle, textColorForFill, textWidthMeasurer, wrapText } from './chunk-BAWLYSUN.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';

package/dist/lint.d.ts

@@ -0,0 +1,70 @@
+import { c as CatalogKind } from './catalogs-HCTav5Wv.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-NPOKUFEX.js';
+import './chunk-GCB6LGJM.js';
+import './chunk-BAWLYSUN.js';
+import './chunk-GQSK3T7X.js';
+import './chunk-TWMRZ43O.js';

package/dist/pagination.d.ts

@@ -35,6 +35,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-X22DFHMW.js';
-import './chunk-HIY26FJV.js';
-import './chunk-NEQAPMS2.js';
+export { OPFPaginationError, paginatePresentation, paginateSlide } from './chunk-TK3QHM3U.js';
+import './chunk-GCB6LGJM.js';
+import './chunk-BAWLYSUN.js';
 import './chunk-GQSK3T7X.js';
 import './chunk-TWMRZ43O.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/types.d.ts

@@ -1,4 +1,4 @@
 export { P as Presentation } from './presentation-BMTdX6O1.js';
-export { A as Audience, c as CatalogKind, 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 } from './catalogs-BnnkUX9O.js';
-export { a as SchemaName } from './schemas--QRVBhU1.js';
+export { A as Audience, c as CatalogKind, 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 } from './catalogs-HCTav5Wv.js';
+export { a as SchemaName } from './schemas-BYe5y8-i.js';
 export { ValidationIssue, ValidationResult } from './validator.js';

package/dist/validator.d.ts

@@ -1,6 +1,6 @@
 import { P as Presentation } from './presentation-BMTdX6O1.js';
-import { c as CatalogKind } from './catalogs-BnnkUX9O.js';
-import { a as SchemaName, J as JsonSchema } from './schemas--QRVBhU1.js';
+import { c as CatalogKind } from './catalogs-HCTav5Wv.js';
+import { a as SchemaName, m as JsonSchema } from './schemas-BYe5y8-i.js';
 
 interface ValidationIssue {
     path: string;

package/dist/validator.js

@@ -1,4 +1,4 @@
-export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './chunk-HIY26FJV.js';
-import './chunk-NEQAPMS2.js';
+export { OPFValidationError, assertValid, assertValidCatalogRecord, assertValidPresentation, validate, validateCatalogRecord, validatePresentation } from './chunk-GCB6LGJM.js';
+import './chunk-BAWLYSUN.js';
 import './chunk-GQSK3T7X.js';
 import './chunk-TWMRZ43O.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpresentation/opf",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Canonical Open Presentation Format schemas, catalogs, TypeScript types, and local validation.",
   "license": "MIT",
   "author": "Open Presentation",
@@ -83,6 +83,10 @@
     "./data": {
       "types": "./dist/data.d.ts",
       "import": "./dist/data.js"
+    },
+    "./lint": {
+      "types": "./dist/lint.d.ts",
+      "import": "./dist/lint.js"
     }
   },
   "files": [
@@ -92,25 +96,26 @@
     "package.json"
   ],
   "engines": {
-    "node": ">=20"
+    "node": "24.x"
   },
   "scripts": {
     "clean": "rm -rf dist src/generated",
     "generate": "node scripts/generate.mjs && node scripts/generate-previews.mjs && node scripts/generate-content.mjs",
     "build": "pnpm run generate && tsup && node scripts/copy-spec.mjs",
-    "typecheck": "pnpm run generate && tsc --noEmit",
+    "typecheck": "pnpm run generate && node ../../scripts/typecheck.mjs --noEmit",
     "test": "pnpm run build && node ../../scripts/run-node-tests.mjs && node test/composition.mjs && node test/pagination.mjs && node test/data.mjs && node test/rich-text.mjs && node test/lists.mjs",
     "test:packed": "node test/packed-install-smoke.mjs",
     "pack:dry-run": "pnpm run build && npm pack --dry-run --cache /tmp/opf-npm-cache"
   },
   "dependencies": {
     "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1"
+    "ajv-formats": "^3.0.1",
+    "jsonc-parser": "3.3.1"
   },
   "devDependencies": {
-    "@types/node": "^20.19.0",
+    "@types/node": "^24.13.4",
     "json-schema-to-typescript": "^16.0.0",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "~5.9.3"
   }
 }