@openpresentation/opf 0.26.2 → 0.26.4

package/README.md

@@ -99,7 +99,7 @@ The layout engine's names are not on the root. `composeSlide`, `fitText`, `layou
 
 ### Source editing: schema field queries, text addressing and syntax recovery
 
-Two browser-safe subpaths for source editors, the CLI and agents. `@openpresentation/opf/schema` reads the field model of a document from the JSON Schemas: `describeField(path, document?)` returns the types, description, enum values, default, examples, whether the parent requires it, the `oneOf` variants (and `primary`, the form a template should use), the ranked `children` of an object (required first, then the curated `COMMON_KEYS` order, then alphabetical; promoted regions, `extensions` and `$schema` are `advanced`), the item schema of an array (`itemInfo`) or map (`entryInfo`), `requiredChildren` and `freeText`, and `{ known: false }` for a path the schema does not describe; `catalogKindAt(path, document?)` names the catalog a reference field points into (`layouts`, `themes`, `colorSchemes`, `fontSchemes`, `narratives`, `audiences`, `purposes`, `tones`) from the `x-opf-catalog` annotation in the schemas, so a new reference field needs no editor change. The navigation helpers it is built on are exported too (`resolveSchema`, `schemaVariants`, `activeSchema`, `schemaAtPath`, `createSchemaValue`, `listSchemaFields`, `splitOpfPath`). `@openpresentation/opf/source` turns text into positions and back: `locate(text, "json", pointer, { part })` is the range of a JSON Pointer (`value`, `key`, `entry`, `open` or `colon`; the nearest ancestor with `exact: false` when the node is missing), `pathAt(text, "json", offset)` the path under a caret, and `analyzeJsonSyntax(text, { limit })` the root cause of each JSON syntax error, once, in position order (at most five), with a range, a message, a hint and the fixes that repair it (`Insert comma`, `Add { }`, `Remove "design"`, `Insert }`, `Use double quotes`, ...); `validate(text)` reports the same causes as `opf/json-syntax` findings. YAML and Markdown addressing is not there yet and returns `undefined`. See [validate](../../docs/validate.md).
+Two browser-safe subpaths for source editors, the CLI and agents. `@openpresentation/opf/schema` reads the field model of a document from the JSON Schemas: `describeField(path, document?)` returns the types, description, enum values, default, examples, whether the parent requires it, the `oneOf` variants (and `primary`, the form a template should use), the ranked `children` of an object (required first, then the curated `COMMON_KEYS` order, then alphabetical; promoted regions, `extensions` and `$schema` are `advanced`), the item schema of an array (`itemInfo`) or map (`entryInfo`), `requiredChildren` and `freeText`, and `{ known: false }` for a path the schema does not describe; `catalogKindAt(path, document?)` names the catalog a reference field points into (`layouts`, `themes`, `colorSchemes`, `fontSchemes`, `narratives`, `audiences`, `purposes`, `tones`) from `schemaCatalogKinds` (also exported), core-side metadata keyed by schema name and JSON Pointer; the published schemas carry no vendor keyword and compile under strict Ajv, so a new reference field is one entry there and needs no editor change. The navigation helpers it is built on are exported too (`resolveSchema`, `schemaVariants`, `activeSchema`, `schemaAtPath`, `createSchemaValue`, `listSchemaFields`, `splitOpfPath`). `@openpresentation/opf/source` turns text into positions and back: `locate(text, format, pointer, { part })` is the range of a JSON Pointer in JSON, YAML or Markdown (`value`, `key`, `entry`, `open` or `colon`; the nearest ancestor with `exact: false` when the node is missing; a Markdown slide field is located by the same ranges its findings use: the `layout=` token of an options comment, the text after `# ` or `- `), `pathAt(text, format, offset)` the path under a caret, `scanMarkdown(text)` the regions of a Markdown deck (front matter, slides, option comments, fences, notes) with the dialect's vocabulary (`SLIDE_OPTION_KEYS`, `BLOCK_OPTION_KEYS`, `FENCE_KINDS`, `METRIC_KEYS`), and `analyzeJsonSyntax(text, { limit })` the root cause of each JSON syntax error, once, in position order (at most five), with a range, a message, a hint and the fixes that repair it (`Insert comma`, `Add { }`, `Remove "design"`, `Insert }`, `Use double quotes`, ...); `validate(text)` reports the same causes as `opf/json-syntax` findings. See [validate](../../docs/validate.md).
 
 ### Validate (0.14.0)
 

package/dist/browser.js

@@ -1,20 +1,22 @@
-import { OPFApiError } from './chunk-OFWBICDO.js';
-export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-OFWBICDO.js';
+import { OPFApiError } from './chunk-NZLW6FBQ.js';
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-NZLW6FBQ.js';
 export { specFileEntries, specFileKinds, specFilePaths } from './chunk-UJSAR6GF.js';
 export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-PJSPHHRK.js';
 export { OPFDataImportError, ingest, parseTabularData } from './chunk-TKQ2VFV5.js';
-export { OPFPaginationError, paginate, paginateSlide } from './chunk-L65YNP4J.js';
-export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-NWO6HT4F.js';
-export { fromMarkdown, toMarkdown } from './chunk-Q6KMKTEH.js';
-import './chunk-CRCOQ4K2.js';
-import './chunk-7YZ72FRP.js';
-export { OPFMarkdownError } from './chunk-6JAFSZVL.js';
-import './chunk-O2ST5ZKL.js';
-export { diff, merge } from './chunk-LN2ASLMF.js';
-export { CATALOG_SCHEMA, DEFAULT_VALIDATION_THRESHOLDS, OPFPatchError, OPFPatchValidationError, OPFValidationError, applyPatch, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-LUQYSUXS.js';
+export { OPFPaginationError, paginate, paginateSlide } from './chunk-QH2W6HIM.js';
+export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-EDCRBTJF.js';
+export { fromMarkdown, toMarkdown } from './chunk-GWJBZ4LC.js';
+import './chunk-PIO73BQ6.js';
+import './chunk-RYZPBJLB.js';
+import './chunk-MN7DRK57.js';
+import './chunk-O6BY3AU2.js';
+export { OPFMarkdownError } from './chunk-QAEBYDKY.js';
+import './chunk-6NBTZYYD.js';
+export { diff, merge } from './chunk-H5QC3X3K.js';
+export { CATALOG_SCHEMA, DEFAULT_VALIDATION_THRESHOLDS, OPFPatchError, OPFPatchValidationError, OPFValidationError, applyPatch, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-XFOOKVRI.js';
 export { CATALOG_GROUP_PATTERN, CATALOG_REFERENCE_PATTERN, CHART_TYPES, DEFAULT_VARIABLE_DATE_FORMAT, ENGINE_DEFAULT_CHART_TYPES, ENGINE_DEFAULT_COLOR_SCHEME, ENGINE_DEFAULT_FONT_SCHEME, ENGINE_DEFAULT_THEME, LANGUAGES, LOGO_SHAPES, OPFCatalogsOptionError, OPFUnresolvedReferenceError, OPFVariableError, SLIDE_SCOPED_BUILTINS, SOCIAL_PLATFORMS, VARIABLE_KINDS, catalogGroupSource, catalogKinds, catalogRecords, catalogReferenceSites, chartNumber, coerceVariableValue, datasetDiagnostics, formatDataNumber, formatVariableNumber, fromExcelNumberFormat, hasContentVariables, inlineChartData, inlineDatasets, inlineTableData, isDatasetRef, isTemplate, isXYChartType, listBuiltinVariables, listVariables, normalizeLanguageFamily, numberFormatError, parseReference, resolveChartData, resolveDesignRecords, resolveFontScheme, resolveReference, resolveSlideVariables, resolveTableData, resolveVariables, suggestChartNumberFix, tableCellDisplayValue, toExcelNumberFormat, unresolvedReference, unusedDatasets, variableDeclarations } from './chunk-XRMV2GMB.js';
-export { OPFFormatError, format } from './chunk-JI3PHXPJ.js';
-export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-N6CNJCIF.js';
+export { OPFFormatError, format } from './chunk-EQ6S5SEZ.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-F4HFDP6I.js';
 
 // src/browser.ts
 var nodeOnly = (name, message) => new OPFApiError(`\`${name}\` ${message}`, "node-only", { details: { function: name, build: "browser" } });

package/dist/{chunk-5VJCLUUA.js → chunk-6IXSHIAL.js}

@@ -1,8 +1,8 @@
-import { defaultCatalogs } from './chunk-XFK4KPKK.js';
-import { localAssetSources, OPFApiError, parseSlideSelection, OPFExportError, asApiError, OPFImportError } from './chunk-OFWBICDO.js';
-import { paginate } from './chunk-L65YNP4J.js';
-import { deckFormatOf, readDeckReport, stringify } from './chunk-NWO6HT4F.js';
-import { validate, OPFValidationError } from './chunk-LUQYSUXS.js';
+import { defaultCatalogs } from './chunk-ZSZDVIDV.js';
+import { localAssetSources, OPFApiError, parseSlideSelection, OPFExportError, asApiError, OPFImportError } from './chunk-NZLW6FBQ.js';
+import { paginate } from './chunk-QH2W6HIM.js';
+import { deckFormatOf, readDeckReport, stringify } from './chunk-EDCRBTJF.js';
+import { validate, OPFValidationError } from './chunk-XFOOKVRI.js';
 import { link, stat, readdir, lstat, readFile, open, unlink, mkdir, rename } from 'fs/promises';
 import path6 from 'path';
 import { readFileSync, statSync, realpathSync } from 'fs';
@@ -117,7 +117,7 @@ function localAssetProblems(deck, root) {
 }
 var RENDER_PACKAGE = "@openpresentation/opf-render";
 var PPTX_PACKAGE = "@openpresentation/opf-pptx";
-var PEER_RANGES = { [RENDER_PACKAGE]: "^0.26.2", [PPTX_PACKAGE]: "^0.26.2" };
+var PEER_RANGES = { [RENDER_PACKAGE]: "^0.26.4", [PPTX_PACKAGE]: "^0.26.4" };
 var PPTX_TEXT_OPTIONS_FROM = "0.22.0";
 var numbers = (version) => version.replace(/[-+].*$/, "").split(".").map((part) => Number.parseInt(part, 10) || 0);
 function atLeast(version, minimum) {

package/dist/{chunk-O2ST5ZKL.js → chunk-6NBTZYYD.js}

@@ -1,4 +1,4 @@
-import { validate } from './chunk-LUQYSUXS.js';
+import { validate } from './chunk-XFOOKVRI.js';
 
 // src/convert/shared.ts
 var CONTENT_KEYS = ["text", "items", "bullets", "image", "video", "chart", "table", "code", "metric", "quote", "timeline"];

package/dist/{chunk-NWO6HT4F.js → chunk-EDCRBTJF.js}

@@ -1,7 +1,7 @@
-import { fromMarkdown, toMarkdown } from './chunk-Q6KMKTEH.js';
-import { fromYaml, toYaml } from './chunk-7YZ72FRP.js';
-import { NOT_CHECKED } from './chunk-6JAFSZVL.js';
-import { parseSource, validate, OPFValidationError } from './chunk-LUQYSUXS.js';
+import { fromMarkdown, toMarkdown } from './chunk-GWJBZ4LC.js';
+import { fromYaml, toYaml } from './chunk-PIO73BQ6.js';
+import { NOT_CHECKED } from './chunk-RYZPBJLB.js';
+import { parseSource, validate, OPFValidationError } from './chunk-XFOOKVRI.js';
 import { checkCatalogsOption } from './chunk-XRMV2GMB.js';
 
 // src/deck-report.ts

package/dist/{chunk-JI3PHXPJ.js → chunk-EQ6S5SEZ.js}

@@ -1,4 +1,4 @@
-import { presentation } from './chunk-N6CNJCIF.js';
+import { presentation } from './chunk-F4HFDP6I.js';
 
 // src/format.ts
 var OPFFormatError = class extends Error {

package/dist/{chunk-N6CNJCIF.js → chunk-F4HFDP6I.js}

@@ -92,7 +92,6 @@ var presentation = {
       ]
     },
     "audience": {
-      "x-opf-catalog": "audiences",
       "oneOf": [
         {
           "type": "string"
@@ -103,7 +102,6 @@ var presentation = {
         {
           "type": "array",
           "items": {
-            "x-opf-catalog": "audiences",
             "oneOf": [
               {
                 "type": "string"
@@ -150,7 +148,6 @@ var presentation = {
       ]
     },
     "purpose": {
-      "x-opf-catalog": "purposes",
       "oneOf": [
         {
           "type": "string"
@@ -205,7 +202,6 @@ var presentation = {
       ]
     },
     "tone": {
-      "x-opf-catalog": "tones",
       "oneOf": [
         {
           "$ref": "#/$defs/CatalogReference"
@@ -298,7 +294,6 @@ var presentation = {
       "default": false
     },
     "narrative": {
-      "x-opf-catalog": "narratives",
       "$ref": "#/$defs/CatalogReference",
       "description": "The deck's narrative plan, by reference: a bare narratives id ('classic-story') or 'name:id' for a record of a named catalogs group ('acme:founder-pitch'). The deck holds only this pointer; the plan (the arc, its beats and what each beat must do) lives in the record, which has the fields of https://openpresentation.org/schema/opf-narrative/v1. A narrative the document defines itself is a record in catalogs.custom.narratives, referenced here by its key.\n\nSlides link themselves to beats with slides[].beat. Core validate warns about a slides[].beat id the resolved narrative does not define and about a root 'duration' outside its 'duration' range, and reports a beat that no slide references. The preview and the PPTX export draw nothing from the narrative; opf-pptx stores the reference for round-trip.\n\nThe reference resolves like every content reference (see catalogs); one that resolves nowhere is the warning opf/unresolved-reference, never an error.\n\nDeck-level concerns that are not part of the storyline (audience, tone, takeaway, duration) live as siblings on the presentation root.",
       "examples": [
@@ -447,7 +442,6 @@ var presentation = {
       ],
       "properties": {
         "id": {
-          "x-opf-catalog": "audiences",
           "$ref": "#/$defs/CatalogReference",
           "description": "Optional audiences reference (a bare id or 'name:id') resolved before applying the inline overrides.",
           "examples": [
@@ -544,7 +538,6 @@ var presentation = {
       ],
       "properties": {
         "id": {
-          "x-opf-catalog": "purposes",
           "$ref": "#/$defs/CatalogReference",
           "description": "Optional purposes reference (a bare id or 'name:id') resolved before applying the inline overrides.",
           "examples": [
@@ -681,12 +674,10 @@ var presentation = {
           ]
         },
         "fontScheme": {
-          "x-opf-catalog": "fontSchemes",
           "$ref": "#/$defs/CatalogReference",
           "description": "Font-scheme reference (a bare id or 'name:id') for this language's script slot when targeting PowerPoint output. Its major/minor families fill the language's script slot (eastAsian or complexScript, chosen by 'script') unless the effective design font scheme sets that slot itself; the latin slot always follows the design font scheme. Without it, engines use the default script fonts of their language vocabulary."
         },
         "googleFontScheme": {
-          "x-opf-catalog": "fontSchemes",
           "$ref": "#/$defs/CatalogReference",
           "description": "Font-scheme reference (a bare id or 'name:id') used in place of 'fontScheme' when resolving script fonts for Google Slides output."
         },
@@ -724,7 +715,6 @@ var presentation = {
       ],
       "properties": {
         "id": {
-          "x-opf-catalog": "tones",
           "$ref": "#/$defs/CatalogReference",
           "description": "Optional tones reference (a bare id or 'name:id') resolved before applying the inline overrides.",
           "examples": [
@@ -1024,7 +1014,6 @@ var presentation = {
       "description": "Visual design system applied to the presentation; individual slides may override fields via Slide.design.",
       "properties": {
         "theme": {
-          "x-opf-catalog": "themes",
           "$ref": "#/$defs/CatalogReference",
           "description": "Theme for the deck: a themes reference, a bare id ('minimal') or 'name:id' ('acme:brand'). The theme supplies the default colour scheme, font scheme, background and dimensions; design.colorScheme, design.fontScheme, design.background and design.dimensions override it field by field. A reference that resolves nowhere is the warning opf/unresolved-reference and engines use the engine default theme.",
           "examples": [
@@ -1035,7 +1024,6 @@ var presentation = {
           ]
         },
         "colorScheme": {
-          "x-opf-catalog": "colorSchemes",
           "oneOf": [
             {
               "type": "string"
@@ -1056,7 +1044,6 @@ var presentation = {
           ]
         },
         "fontScheme": {
-          "x-opf-catalog": "fontSchemes",
           "oneOf": [
             {
               "type": "string"
@@ -1300,7 +1287,6 @@ var presentation = {
       "description": "Color palette used by the design system. Every slot and role is a hex color ('#RGB', '#RRGGBB' or '#RRGGBBAA'); a color-scheme name or a 'var:<id>' reference is not valid here, because those resolve through the scheme. The slot fields (accent1-accent6, dark1, dark2, light1, light2, hyperlink, followedHyperlink) mirror color-scheme.schema.json (https://openpresentation.org/schema/opf-color-scheme/v1) so library records and inline OPF overrides are interchangeable on those fields.\n\nTwo parallel models are supported and may be mixed:\n- OOXML slots - the 12-slot PowerPoint theme model that round-trips directly to OOXML. Use these for full control over the palette as PowerPoint sees it.\n- Abstract roles (primary, secondary, accent, background, surface, text, textSecondary) - OPF-specific semantic aliases the engine maps onto the OOXML slots. Convenient for inline overrides without thinking in slot numbers; not part of the catalog record schema.\n\nIn design.colorScheme, 'id' resolves a colorSchemes record as the base; slot and role overrides on the same object take precedence over the resolved scheme. The string form of design.colorScheme is equivalent to setting only 'id'.",
       "properties": {
         "id": {
-          "x-opf-catalog": "colorSchemes",
           "$ref": "#/$defs/CatalogReference",
           "description": "Colour-scheme reference (a bare id or 'name:id') resolved as the base; slot and role overrides on the surrounding ColorScheme object take precedence over the resolved scheme.",
           "examples": [
@@ -1474,7 +1460,6 @@ var presentation = {
       "description": "Typography selections used by the design system. The pair fields (major, minor) and refinement fields (type, app, languageFamily) mirror font-scheme.schema.json (https://openpresentation.org/schema/opf-font-scheme/v1) so library records and inline OPF overrides are interchangeable on those fields.\n\nTwo parallel models are supported and may be mixed:\n- OOXML pairs (major, minor) - heading and body family names that round-trip directly to PowerPoint majorFont/minorFont entries.\n- Abstract roles (heading, body, accent, code) - OPF-specific font family names the engine maps onto the OOXML pair when serializing. Convenient for inline overrides and for adding accent/code roles that don't have a direct OOXML slot. Catalog records may also carry 'code' (for example the consolas and courier-new records); heading, body and accent are not part of the catalog record schema. A role is a family name only: weight, style and tracking come from the text styles, and PowerPoint has no numeric weight.\n\nIn design.fontScheme, 'id' resolves a fontSchemes record as the base; pair and role overrides on the same object take precedence over the resolved scheme. The string form of design.fontScheme is equivalent to setting only 'id'.",
       "properties": {
         "id": {
-          "x-opf-catalog": "fontSchemes",
           "$ref": "#/$defs/CatalogReference",
           "description": "Font-scheme reference (a bare id or 'name:id') resolved as the base; field overrides on the surrounding FontScheme object take precedence over the resolved scheme.",
           "examples": [
@@ -2870,7 +2855,6 @@ var presentation = {
           "description": "Optional reference to one or more beats of the deck's narrative (each value is the id of a beat in the narrative record that the root 'narrative' resolves to). A single string declares the slide's primary beat; an array declares that one slide covers multiple beats. Declares the slide's role in the story arc; does not constrain ordering or structure. Core validate warns about a beat id the resolved narrative does not define, and reports a beat that no slide references. Slides without a beat are valid; multiple slides may share a beat."
         },
         "layout": {
-          "x-opf-catalog": "layouts",
           "$ref": "#/$defs/CatalogReference",
           "description": "Optional layout: a layouts reference, a bare id ('pillars') or 'name:id' ('acme:hero'), or 'auto'. When omitted or 'auto', the slide is composed with no layout record: engines arrange title, subtitle, tag and content automatically, a slide with no body payload is a cover (vertically centered), and design hints apply; there is no finding. 'auto' is reserved, so no catalog may define a layout of that id, and opf format drops it. A layout is a grid template (layout.schema.json): the slide's content stays flat and binds to the layout's regions by reading order, role and kind, a block may pin itself to a region with 'region', and an empty region collapses. A reference that resolves nowhere is the warning opf/unresolved-reference (and the 'unresolved-reference' diagnostic of resolveSlideContext), the slide composes automatically, and a strict export fails. A layout id of the 0.18 default catalog that 0.19 no longer has is such a reference: 0.19 has no migration path for layouts. A layout never changes what a slide contains, and engines never substitute a different layout.",
           "examples": [
@@ -6466,7 +6450,6 @@ var theme = {
       ]
     },
     "colorScheme": {
-      "x-opf-catalog": "colorSchemes",
       "type": "string",
       "pattern": "^(?:[a-z][a-z0-9-]*:)?[a-z][a-z0-9-]*$",
       "description": "The theme's default colour scheme: a reference (a bare id or 'name:id') resolved like design.colorScheme, but in the theme's own catalogs group first.",
@@ -6477,7 +6460,6 @@ var theme = {
       ]
     },
     "fontScheme": {
-      "x-opf-catalog": "fontSchemes",
       "type": "string",
       "pattern": "^(?:[a-z][a-z0-9-]*:)?[a-z][a-z0-9-]*$",
       "description": "The theme's default font scheme: a reference (a bare id or 'name:id') resolved like design.fontScheme, but in the theme's own catalogs group first.",