@openpresentation/opf 0.26.1 → 0.26.3

package/README.md

@@ -97,6 +97,10 @@ The layout engine's names are not on the root. `composeSlide`, `fitText`, `layou
 
 `@openpresentation/opf/yaml` reads and writes a deck as YAML, the authoring form of the same data (JSON stays canonical). `fromYaml(text, { aliases, validate })` reads strict JSON-compatible YAML 1.2 (one document, a mapping at the root, no custom tags, duplicate keys or non-finite numbers; anchors, aliases and merge keys only with `aliases: true`) and returns `{ presentation, valid, findings, counts, schemaValid, checks }`: the `validate` report of the deck, with every finding (the shared `Finding` format, YAML syntax errors as `yaml/<rule>` findings) located at the line and column of the YAML. `toYaml(presentation, { schemaComment })` writes canonical YAML (schema key order, block style, ambiguous strings quoted) that reads back to the same deck, and throws `OPFYamlError` for an invalid one. `parseYamlData` and `scanYamlComments` are the helpers. See [the YAML guide](../../docs/yaml.md).
 
+### 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 `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, "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).
+
 ### Validate (0.14.0)
 
 `validate(input, options?)` is the one checker, from the root and from `@openpresentation/opf/validator`. `input` is a parsed presentation or strict JSON text; the result is a `ValidationReport` whose `findings` (the shared `Finding` format, `spec/schemas/finding.schema.json`) each have a stable `opf/<rule>` id, a severity and one of six categories: `format` (JSON syntax, duplicate keys, schema), `references` (catalog references, assets, citations, datasets), `policy` (host `contracts`), `accessibility` (contrast, alt text, reading order, links), `layout` (overflow, type size, image resolution, fonts) and `content` (placeholders, empty slides, non-numeric chart cells). `valid` means no finding has severity `error`, which by default only `format`, `references` and `policy` findings can have. Text input adds line and column; `only`, `ignore` and `severity` pick and promote rules or categories; composition is lazy, so `validate(deck, { only: ["format"] })` costs what a schema check costs. Read-only and deterministic: no remote resources are fetched. See [the validate guide](../../docs/validate.md). A clean report does not certify layout, fonts, or native export fidelity.

package/dist/browser.js

@@ -1,21 +1,20 @@
-import { OPFApiError } from './chunk-WW62PPYV.js';
-export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-WW62PPYV.js';
+import { OPFApiError } from './chunk-GLLR3AQ5.js';
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, stats, updateFromCatalog } from './chunk-GLLR3AQ5.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 { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-3OE6PZIC.js';
-export { fromMarkdown, toMarkdown } from './chunk-MJ57RSYO.js';
-import './chunk-F5ABHDUX.js';
-export { OPFMarkdownError } from './chunk-GS37EBPQ.js';
-export { diff, merge } from './chunk-X7RANZWP.js';
-export { OPFPatchError, OPFPatchValidationError, applyPatch } from './chunk-IY5SCRTV.js';
-export { OPFFormatError, format } from './chunk-EQ6S5SEZ.js';
-export { OPFPaginationError, paginate, paginateSlide } from './chunk-FITOGMR3.js';
-import './chunk-IWFXFWGD.js';
-import './chunk-LU6XM5JQ.js';
-export { CATALOG_SCHEMA, DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-P7S3ORB4.js';
+export { OPFPaginationError, paginate, paginateSlide } from './chunk-54OV2WQC.js';
+export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-FXNUM2PN.js';
+export { fromMarkdown, toMarkdown } from './chunk-WASENX2R.js';
+import './chunk-7RY7QWWJ.js';
+import './chunk-PB5X2VSV.js';
+export { OPFMarkdownError } from './chunk-DEI2M2H6.js';
+import './chunk-PXOXTJTN.js';
+export { diff, merge } from './chunk-YVNFACTC.js';
+export { CATALOG_SCHEMA, DEFAULT_VALIDATION_THRESHOLDS, OPFPatchError, OPFPatchValidationError, OPFValidationError, applyPatch, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validate, validateCatalogRecord, validationCategories, validationRules } from './chunk-NJWI6MPT.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-EQ6S5SEZ.js';
 export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-F4HFDP6I.js';
-export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-PJSPHHRK.js';
 
 // src/browser.ts
 var nodeOnly = (name, message) => new OPFApiError(`\`${name}\` ${message}`, "node-only", { details: { function: name, build: "browser" } });

package/dist/{catalog-refs-CSHevLn1.d.ts → catalog-refs-BSfGELpt.d.ts}

@@ -125,4 +125,4 @@ declare function catalogReferenceSites(document: unknown, options?: {
 /** Records a picker can offer for `kind`: the document's embedded records, then those of the registered catalogs its groups name, with the reference to write for each. */
 declare function catalogRecords(document: unknown, kind: CatalogKind, options?: CatalogOptions): ResolvedReference[];
 
-export { type Catalog as C, OPFCatalogsOptionError as O, type RecordProvenance as R, type UnresolvedReferenceDiagnostic as U, type CatalogOptions as a, type CatalogKind as b, CATALOG_GROUP_PATTERN as c, CATALOG_REFERENCE_PATTERN as d, type CatalogRecordMap as e, type CatalogRecords as f, type CatalogReferenceSite as g, OPFUnresolvedReferenceError as h, type ResolvedReference as i, catalogGroupSource as j, catalogKinds as k, catalogRecords as l, catalogReferenceSites as m, parseReference as p, resolveReference as r, unresolvedReference as u };
+export { type CatalogKind as C, OPFCatalogsOptionError as O, type RecordProvenance as R, type UnresolvedReferenceDiagnostic as U, type Catalog as a, type CatalogOptions as b, CATALOG_GROUP_PATTERN as c, CATALOG_REFERENCE_PATTERN as d, type CatalogRecordMap as e, type CatalogRecords as f, type CatalogReferenceSite as g, OPFUnresolvedReferenceError as h, type ResolvedReference as i, catalogGroupSource as j, catalogKinds as k, catalogRecords as l, catalogReferenceSites as m, parseReference as p, resolveReference as r, unresolvedReference as u };

package/dist/catalog-schemas-DoxA2BgY.d.ts

@@ -0,0 +1,19 @@
+import { C as CatalogKind } from './catalog-refs-BSfGELpt.js';
+import { SchemaName } from './schemas.js';
+
+/**
+ * RR-78: the version of the catalog record schemas (spec/schemas/<kind>.schema.json) this core reads. A catalog package
+ * declares the version its records target (`opf.catalogSchema` in its package.json, `CATALOG_SCHEMA` in its exports, as
+ * @openpresentation/gallery does); the Node defaults refuse a gallery that targets another one. A record schema change that
+ * old records no longer validate against raises it.
+ */
+declare const CATALOG_SCHEMA = 4;
+/** Kinds of catalog display metadata: published by catalogs for pickers, never referenced by documents. */
+declare const catalogDisplayKinds: readonly ["chartTypes", "languages", "socialPlatforms"];
+type CatalogDisplayKind = (typeof catalogDisplayKinds)[number];
+/** Every kind of record a catalog publishes: the content kinds documents reference, and the display kinds. */
+type CatalogRecordKind = CatalogKind | CatalogDisplayKind;
+/** The companion schema each catalog record kind validates against. */
+declare const catalogSchemaNames: Readonly<Record<CatalogRecordKind, SchemaName>>;
+
+export { type CatalogRecordKind as C, CATALOG_SCHEMA as a, type CatalogDisplayKind as b, catalogDisplayKinds as c, catalogSchemaNames as d };

package/dist/{chunk-IC6OPLMU.js → chunk-2ZQBMZTZ.js}

@@ -1,5 +1,5 @@
-import { OPFApiError } from './chunk-WW62PPYV.js';
-import { CATALOG_SCHEMA } from './chunk-P7S3ORB4.js';
+import { OPFApiError } from './chunk-GLLR3AQ5.js';
+import { CATALOG_SCHEMA } from './chunk-NJWI6MPT.js';
 import { CATALOG_SCHEMA as CATALOG_SCHEMA$1, gallery } from '@openpresentation/gallery';
 
 function galleryMismatch(declared, reads = CATALOG_SCHEMA) {

package/dist/{chunk-JIHHLV47.js → chunk-34LIUOT7.js}

@@ -1,8 +1,8 @@
-import { defaultCatalogs } from './chunk-IC6OPLMU.js';
-import { localAssetSources, OPFApiError, parseSlideSelection, OPFExportError, asApiError, OPFImportError } from './chunk-WW62PPYV.js';
-import { deckFormatOf, readDeckReport, stringify } from './chunk-3OE6PZIC.js';
-import { paginate } from './chunk-FITOGMR3.js';
-import { validate, OPFValidationError } from './chunk-P7S3ORB4.js';
+import { defaultCatalogs } from './chunk-2ZQBMZTZ.js';
+import { localAssetSources, OPFApiError, parseSlideSelection, OPFExportError, asApiError, OPFImportError } from './chunk-GLLR3AQ5.js';
+import { paginate } from './chunk-54OV2WQC.js';
+import { deckFormatOf, readDeckReport, stringify } from './chunk-FXNUM2PN.js';
+import { validate, OPFValidationError } from './chunk-NJWI6MPT.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.1", [PPTX_PACKAGE]: "^0.26.1" };
+var PEER_RANGES = { [RENDER_PACKAGE]: "^0.26.3", [PPTX_PACKAGE]: "^0.26.3" };
 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-FITOGMR3.js → chunk-54OV2WQC.js}

@@ -1,4 +1,4 @@
-import { assertValid, resolveSlideScriptMeasurement, resolveSlideContext } from './chunk-P7S3ORB4.js';
+import { assertValid, resolveSlideScriptMeasurement, resolveSlideContext } from './chunk-NJWI6MPT.js';
 import { resolveSlideVariables, checkCatalogsOption, usesSlideBuiltin, composeSlide, codeHighlightSlice, tableRowBoundaries, visitContentPayloads, regionAccepts, slideTokenSpans, sliceNumberedItems } from './chunk-XRMV2GMB.js';
 
 // src/pagination.ts

package/dist/{chunk-IWFXFWGD.js → chunk-7RY7QWWJ.js}

@@ -1,4 +1,4 @@
-import { runText } from './chunk-LU6XM5JQ.js';
+import { runText } from './chunk-PXOXTJTN.js';
 
 // src/convert/text-lines.ts
 var LIST_PREFIX = /^([ \t]*)(?:([-*•+]|\d{1,3}[.)])[ \t]+)?/;

package/dist/{chunk-GS37EBPQ.js → chunk-DEI2M2H6.js}

@@ -1,4 +1,4 @@
-import { isRecord, same } from './chunk-LU6XM5JQ.js';
+import { isRecord, same } from './chunk-PXOXTJTN.js';
 import { parseDocument, YAMLMap, Scalar, stringify } from 'yaml';
 
 // src/not-checked.ts

package/dist/{chunk-3OE6PZIC.js → chunk-FXNUM2PN.js}

@@ -1,7 +1,7 @@
-import { fromMarkdown, toMarkdown } from './chunk-MJ57RSYO.js';
-import { fromYaml, toYaml } from './chunk-F5ABHDUX.js';
-import { NOT_CHECKED } from './chunk-GS37EBPQ.js';
-import { parseSource, validate, OPFValidationError } from './chunk-P7S3ORB4.js';
+import { fromMarkdown, toMarkdown } from './chunk-WASENX2R.js';
+import { fromYaml, toYaml } from './chunk-PB5X2VSV.js';
+import { NOT_CHECKED } from './chunk-DEI2M2H6.js';
+import { parseSource, validate, OPFValidationError } from './chunk-NJWI6MPT.js';
 import { checkCatalogsOption } from './chunk-XRMV2GMB.js';
 
 // src/deck-report.ts

package/dist/{chunk-WW62PPYV.js → chunk-GLLR3AQ5.js}

@@ -1,6 +1,5 @@
 import { OPFDataImportError, parseTabularData } from './chunk-TKQ2VFV5.js';
-import { applyPatchWithInverse } from './chunk-IY5SCRTV.js';
-import { validate, OPFValidationError } from './chunk-P7S3ORB4.js';
+import { applyPatchWithInverse, validate, OPFValidationError } from './chunk-NJWI6MPT.js';
 import { embeddedCopy, checkCatalogsOption, catalogReferenceSites, parseReference, catalogGroupDeclared, resolveReference, dottedPath, unresolvedReference, recordReferenceSites, catalogGroupSource, registeredCatalog, catalogKinds, CATALOG_GROUP_PATTERN, isRecord, visitContentPayloads, annotationText, listVariables, resolveVariables, LOGO_SHAPES, resolveDesignRecords, resolveFontFamilies, resolveCanvasDimensions, imageBackground } from './chunk-XRMV2GMB.js';
 
 // src/api-errors.ts