@openpresentation/opf 0.26.10 → 0.28.0

package/dist/ids.js

@@ -0,0 +1,6 @@
+export { OPFIdError, assignIds, touches } from './chunk-CR72ZJ6W.js';
+export { OPFPatchHashError, documentHash, idToken, isIdToken, resolveIdPatch, resolveIdPointer, toIdPatch, toIdPointer } from './chunk-WPKCWQ6W.js';
+import './chunk-JBARNYFR.js';
+import './chunk-5Q4IYLMW.js';
+import './chunk-2CUCYENF.js';
+import './chunk-GM7WFPGG.js';

package/dist/index.d.ts

@@ -1,31 +1,33 @@
 export { SchemaEntry, SchemaName, audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './schemas.js';
-import { C as ConvertInput, a as ConvertOptions, b as ConvertResult, c as ConvertFormat, O as OpenOptions, S as SaveOptions, d as SaveResult } from './conversion-ChmGA8Ul.js';
-export { e as ConvertedFile, E as ExportFormat, F as FontsHandle, f as OPFApiError, g as OPFExportError, h as OPFImportError, i as SlideSelection, p as parseSlideSelection } from './conversion-ChmGA8Ul.js';
-export { R as RuleExplanation, e as explain } from './explain-JSuESV-Y.js';
+import { a3 as ConvertInput, a4 as ConvertOptions, a5 as ConvertResult, a6 as ConvertFormat, a7 as OpenOptions, a8 as SaveOptions, a9 as SaveResult } from './conversion-hbZeS5kD.js';
+export { aa as ConvertedFile, h as ExportFormat, F as FontsHandle, O as OPFApiError, n as OPFExportError, o as OPFImportError, S as SlideSelection, U as parseSlideSelection } from './conversion-hbZeS5kD.js';
+export { R as RuleExplanation, e as explain } from './explain-iZeNOUc6.js';
 import { validate as validate$1 } from './validator.js';
 export { DEFAULT_VALIDATION_THRESHOLDS, OPFValidationError, assertValid, assertValidCatalogRecord, findValidationRule, validateCatalogRecord, validationRules } from './validator.js';
-import { R as ResolveVariablesOptions, h as VariableDiagnostic } from './validation-types-3ARvTsB0.js';
-export { B as BuiltinVariableInfo, C as Contract, D as DEFAULT_VARIABLE_DATE_FORMAT, O as OPFVariableError, i as ResolveVariablesResult, j as VARIABLE_KINDS, d as ValidateFonts, a as ValidateOptions, e as ValidationCategory, f as ValidationChecks, V as ValidationReport, g as ValidationRuleCost, c as ValidationRuleInfo, b as ValidationThresholds, k as VariableDeclaration, l as VariableDiagnosticCode, m as VariableDiagnosticSeverity, n as VariableInfo, o as VariableKind, p as VariableUse, q as VariableUseForm, r as VariableValues, s as coerceVariableValue, t as formatVariableNumber, u as hasContentVariables, w as isTemplate, x as listBuiltinVariables, y as listVariables, z as resolveVariables, v as validationCategories, A as variableDeclarations } from './validation-types-3ARvTsB0.js';
-export { a as CHART_TYPES, C as ComposeSlideOptions, E as ENGINE_DEFAULT_CHART_TYPES, b as ENGINE_DEFAULT_COLOR_SCHEME, c as ENGINE_DEFAULT_FONT_SCHEME, d as ENGINE_DEFAULT_THEME, e as FontFamilies, F as Fonts, f as LANGUAGES, g as LOGO_SHAPES, h as LanguageFamilyName, i as LanguageVocabulary, L as LayoutDiagnostic, j as LogoShape, k as LogoVariant, M as MeasureTextWidth, l as ResolveLogoOptions, m as ResolvedLogo, S as SOCIAL_PLATFORMS, n as SocialPlatformVocabulary, T as TextMeasurement, o as TextStyle, p as normalizeLanguageFamily } from './composition-DIftf6iP.js';
+import { R as ResolveVariablesOptions, h as VariableDiagnostic } from './validation-types-mNmfcY9A.js';
+export { B as BuiltinVariableInfo, C as Contract, D as DEFAULT_VARIABLE_DATE_FORMAT, O as OPFVariableError, i as ResolveVariablesResult, j as VARIABLE_KINDS, d as ValidateFonts, a as ValidateOptions, e as ValidationCategory, f as ValidationChecks, V as ValidationReport, g as ValidationRuleCost, c as ValidationRuleInfo, b as ValidationThresholds, k as VariableDeclaration, l as VariableDiagnosticCode, m as VariableDiagnosticSeverity, n as VariableInfo, o as VariableKind, p as VariableUse, q as VariableUseForm, r as VariableValues, s as coerceVariableValue, t as formatVariableNumber, u as hasContentVariables, w as isTemplate, x as listBuiltinVariables, y as listVariables, z as resolveVariables, v as validationCategories, A as variableDeclarations } from './validation-types-mNmfcY9A.js';
+import { a as FontFamilies, T as TextMeasurement } from './composition-C-hd_Ci3.js';
+export { b as CHART_TYPES, C as ComposeSlideOptions, E as ENGINE_DEFAULT_CHART_TYPES, c as ENGINE_DEFAULT_COLOR_SCHEME, d as ENGINE_DEFAULT_FONT_SCHEME, e as ENGINE_DEFAULT_THEME, F as Fonts, f as LANGUAGES, g as LOGO_SHAPES, h as LanguageFamilyName, i as LanguageVocabulary, L as LayoutDiagnostic, j as LogoShape, k as LogoVariant, M as MeasureTextWidth, l as ResolveLogoOptions, m as ResolvedLogo, S as SOCIAL_PLATFORMS, n as SocialPlatformVocabulary, o as TextStyle, p as normalizeLanguageFamily } from './composition-C-hd_Ci3.js';
 export { SpecFileEntry, SpecFileKind, SpecFilePath, specFileEntries, specFileKinds, specFilePaths } from './spec-files.js';
-import { P as Presentation } from './presentation-Bwo8Ko6D.js';
+import { P as Presentation } from './presentation-8jLSTFqL.js';
 export { Audience, ChartType, ColorScheme, FontScheme, Language, Layout, Narrative, Purpose, SocialPlatform, Theme, Tone } from './types.js';
-import { C as CatalogKind, U as UnresolvedReferenceDiagnostic, b as CatalogOptions, a as Catalog, R as RecordProvenance } from './catalog-refs-BSfGELpt.js';
-export { c as CATALOG_GROUP_PATTERN, d as CATALOG_REFERENCE_PATTERN, e as CatalogRecordMap, f as CatalogRecords, g as CatalogReferenceSite, O as OPFCatalogsOptionError, h as OPFUnresolvedReferenceError, i as ResolvedReference, j as catalogGroupSource, k as catalogKinds, l as catalogRecords, m as catalogReferenceSites, p as parseReference, r as resolveReference, u as unresolvedReference } from './catalog-refs-BSfGELpt.js';
+import { a as CatalogKind, U as UnresolvedReferenceDiagnostic, b as CatalogOptions, C as Catalog, R as RecordProvenance } from './catalog-refs-kAefsZWT.js';
+export { c as CATALOG_GROUP_PATTERN, d as CATALOG_REFERENCE_PATTERN, e as CatalogRecordMap, f as CatalogRecords, g as CatalogReferenceSite, O as OPFCatalogsOptionError, h as OPFUnresolvedReferenceError, i as ResolvedReference, j as catalogGroupSource, k as catalogKinds, l as catalogRecords, m as catalogReferenceSites, p as parseReference, r as resolveReference, u as unresolvedReference } from './catalog-refs-kAefsZWT.js';
 import { a as Finding, J as JsonPatchOperation } from './finding-l9dlQ2NF.js';
 export { d as FindingCategory, e as FindingFix, f as FindingFocus, b as FindingLocation, F as FindingReport, c as FindingSeverity, g as FindingSuggestion, V as ValidationIssue } from './finding-l9dlQ2NF.js';
-export { a as CATALOG_SCHEMA, b as CatalogDisplayKind, C as CatalogRecordKind, c as catalogDisplayKinds, d as catalogSchemaNames } from './catalog-schemas-DoxA2BgY.js';
-import { p as paginate$1 } from './pagination-D_kJe4jH.js';
-export { O as OPFPaginationError, P as PaginatedPage, b as PaginationMapping, c as PaginationOptions, d as PaginationResult, a as PresentationPaginationOptions, e as PresentationPaginationResult, S as SlideContext, f as SlideContextDiagnostic, g as SlideContextOptions, h as paginateSlide, r as resolveSlideContext } from './pagination-D_kJe4jH.js';
-export { ApplyPatchOptions, OPFPatchError, OPFPatchValidationError, PatchResult, applyPatch } from './patch.js';
+export { a as CATALOG_SCHEMA, b as CatalogDisplayKind, C as CatalogRecordKind, c as catalogDisplayKinds, d as catalogSchemaNames } from './catalog-schemas-CC1d_h8s.js';
+import { paginate as paginate$1 } from './pagination.js';
+export { O as OPFPaginationError, P as PaginatedPage, c as PaginationMapping, d as PaginationOptions, e as PaginationResult, a as PresentationPaginationOptions, b as PresentationPaginationResult, S as SlideContext, f as SlideContextDiagnostic, g as SlideContextOptions, h as paginateSlide, r as resolveSlideContext } from './pagination-DyAKYpXu.js';
+export { ApplyPatchOptions, OPFPatchError, OPFPatchHashError, OPFPatchValidationError, PatchResult, applyPatch, documentHash, idToken, isIdToken, resolveIdPatch, resolveIdPointer, toIdPatch, toIdPointer } from './patch.js';
+export { AssignIdsContext, AssignIdsOptions, AssignIdsResult, AssignedId, IdErrorCode, OPFIdError, PatchScope, PatchScopeKind, PatchTouch, assignIds, touches } from './ids.js';
 export { DiffOptions, MergeConflict, MergeOptions, MergeResult, PresentationDiff, diff, merge } from './diff.js';
 export { FormatOptions, OPFFormatError, format } from './format.js';
 export { FromMarkdownOptions, FromMarkdownResult, OPFMarkdownError, ToMarkdownOptions, ToMarkdownResult, fromMarkdown, toMarkdown } from './markdown.js';
 export { StringifyOptions, parse, stringify } from './deck.js';
 export { DataCell, DataImportOptions, ImportedChart, ImportedChartData, ImportedChartType, ImportedTable, IngestOptions, OPFDataImportError, TabularData, ingest, parseTabularData } from './data.js';
-export { I as ChartComboSeries, C as ChartMapping, a as ChartNumberFix, b as ChartNumberFixOperation, c as ChartNumberFixOptions, D as DataCellValue, d as DataColumn, e as DataDiagnostic, f as DataDiagnosticCode, g as DataResolveOptions, h as DataSourceRef, i as DataStyledCell, j as DataTableCell, k as DataTableHeader, l as DataTableValue, m as DataTextRun, n as Dataset, o as DatasetRef, R as ResolvedChartData, p as ResolvedTableData, q as chartNumber, r as datasetDiagnostics, s as formatDataNumber, t as fromExcelNumberFormat, u as inlineChartData, v as inlineDatasets, w as inlineTableData, x as isDatasetRef, y as isXYChartType, z as numberFormatError, A as resolveChartData, B as resolveTableData, E as suggestChartNumberFix, F as tableCellDisplayValue, G as toExcelNumberFormat, H as unusedDatasets } from './chart-data-BnNqgnC-.js';
+export { I as ChartComboSeries, C as ChartMapping, a as ChartNumberFix, b as ChartNumberFixOperation, c as ChartNumberFixOptions, D as DataCellValue, d as DataColumn, e as DataDiagnostic, f as DataDiagnosticCode, g as DataResolveOptions, h as DataSourceRef, i as DataStyledCell, j as DataTableCell, k as DataTableHeader, l as DataTableValue, m as DataTextRun, n as Dataset, o as DatasetRef, R as ResolvedChartData, p as ResolvedTableData, q as chartNumber, r as datasetDiagnostics, s as formatDataNumber, t as fromExcelNumberFormat, u as inlineChartData, v as inlineDatasets, w as inlineTableData, x as isDatasetRef, y as isXYChartType, z as numberFormatError, A as resolveChartData, B as resolveTableData, E as suggestChartNumberFix, F as tableCellDisplayValue, G as toExcelNumberFormat, H as unusedDatasets } from './chart-data-Ci9s_NDN.js';
 export { FONT_POLICY, FontAvailability, FontAvailabilityCode, FontAvailabilityDiagnostic, FontLicenseClass, FontPolicyDecision, FontPolicyEntry, FontPolicyTable, FontReplacement, FontReplacementCompatibility, FontReplacementMeasurement, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './font-policy.js';
-export { a as DECK_FORMATS, D as DeckFormat, P as ParseOptions, d as deckFormatOf } from './deck-report-5vwMGcQz.js';
+export { a as DECK_FORMATS, D as DeckFormat, P as ParseOptions, d as deckFormatOf } from './deck-report-DQMsvyBI.js';
 import './json-BFSdESOE.js';
 
 /**
@@ -583,6 +585,8 @@ interface EditOptions {
     catalogs?: readonly Catalog[];
     /** `false` skips the check of the result (work in progress). Default true. */
     validate?: boolean;
+    /** Apply the patch only to the deck whose `documentHash` this is; a different deck throws `OPFPatchHashError` before anything is applied. */
+    expectHash?: string;
 }
 interface EditResult {
     /** The patched deck (a copy). */
@@ -644,6 +648,25 @@ declare function fillRecords(raw: string, options?: Pick<FillOptions, "format" |
  */
 declare function fill(template: unknown, data?: string | FillRecord | readonly FillRecord[], options?: FillOptions): FillResult;
 
+/**
+ * The role families a slide composes with when a host measures text (WI-1, P24): each role family resolves once through
+ * the host's measurement (heading at weight 700, the others at 400), and composition then asks for the family the host
+ * draws. With the renderer's fonts, Aptos Display becomes Intos Display, its open replacement, and a run at a weight that
+ * face does not have (a metric value at 800, a quote at 600) draws its nearest weight, which the registry records as a
+ * visual substitution. This is the resolution `toSvg` composes with, so `validate` and `paginate` measure the same slide
+ * the renderer draws instead of failing on a weight the replacement lacks.
+ *
+ * Two kinds of family keep their own name, as in the renderer since RR-17 and FF-45: a family that names its weight
+ * (Arial Black, Segoe UI Semibold: at weight 400 the host draws another weight) resolves again on every run to its
+ * replacement's encoded weight, and a symbol-encoded family (Symbol, Wingdings: the host's resolved style carries
+ * `symbolEncoding`) keeps its encoding for the script planner. By default both are read from the host's own resolution,
+ * so core needs neither the font policy table nor the symbol tables here; a host that holds those tables (the renderer)
+ * passes `keepsName` and decides from them, with no extra resolution. Without a measurement that resolves styles the
+ * families are returned unchanged, and a family the host cannot resolve keeps its name, so a run that uses it fails with
+ * the host's error and a slide that never draws it is not affected.
+ */
+declare function resolveDrawnFontFamilies<T extends Partial<FontFamilies>>(families: T, measurement: TextMeasurement | undefined, keepsName?: (family: string, resolved: string) => boolean): T;
+
 /** `validate` with the gallery registered when `catalogs` is omitted, as `opf validate` does. */
 declare const validate: typeof validate$1;
 /** `stats` with the gallery registered when `catalogs` is omitted, as `opf stats` does. */
@@ -695,4 +718,5 @@ declare function open(input: string | Uint8Array | ArrayBuffer, options?: OpenOp
  */
 declare function save(deck: Presentation, path: string, options?: SaveOptions): Promise<SaveResult>;
 
-export { Catalog, CatalogKind, CatalogOptions, type CatalogPatchOperation, type CatalogRecordChange, type CatalogRef, type CatalogUpdate, ConvertFormat, ConvertInput, ConvertOptions, ConvertResult, type CopiedRecordRename, type CopySlidesResult, type DatasetFact, type EditOptions, type EditResult, type EmbedResult, type EmbeddedRecord, type FillOptions, type FillRecord, type FillResult, type FilledDeck, Finding, type HeaderFooterFact, JsonPatchOperation, type MoveToCustomErrorCode, type MoveToCustomPatchOperation, type MoveToCustomResult, type MovedRecord, OPFMoveToCustomError, OpenOptions, Presentation, type PresentationStats, RecordProvenance, type ReferenceFact, ResolveVariablesOptions, type ResolvedDesignRecords, SLIDE_SCOPED_BUILTINS, SaveOptions, SaveResult, type SlideScopedBuiltin, type SlideSizeFact, type SlideStats, type StatsOptions, type StatsSlideRef, type TableFact, UnresolvedReferenceDiagnostic, VariableDiagnostic, convert, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, open, paginate, resolveDesignRecords, resolveFontScheme, resolveSlideVariables, sameRecord, save, stats, updateFromCatalog, validate };
+export { Catalog, CatalogKind, CatalogOptions, ConvertFormat, ConvertInput, ConvertOptions, ConvertResult, Finding, FontFamilies, JsonPatchOperation, OPFMoveToCustomError, OpenOptions, Presentation, RecordProvenance, ResolveVariablesOptions, SLIDE_SCOPED_BUILTINS, SaveOptions, SaveResult, TextMeasurement, UnresolvedReferenceDiagnostic, VariableDiagnostic, convert, copySlides, edit, embed, fill, fillRecords, localAssetSources, moveToCustom, open, paginate, resolveDesignRecords, resolveDrawnFontFamilies, resolveFontScheme, resolveSlideVariables, sameRecord, save, stats, updateFromCatalog, validate };
+export type { CatalogPatchOperation, CatalogRecordChange, CatalogRef, CatalogUpdate, CopiedRecordRename, CopySlidesResult, DatasetFact, EditOptions, EditResult, EmbedResult, EmbeddedRecord, FillOptions, FillRecord, FillResult, FilledDeck, HeaderFooterFact, MoveToCustomErrorCode, MoveToCustomPatchOperation, MoveToCustomResult, MovedRecord, PresentationStats, ReferenceFact, ResolvedDesignRecords, SlideScopedBuiltin, SlideSizeFact, SlideStats, StatsOptions, StatsSlideRef, TableFact };

package/dist/index.js

@@ -1,26 +1,29 @@
-import { defaultCatalogs } from './chunk-NVT2YDVC.js';
-import { stats, embed, edit, OPFApiError, asApiError } from './chunk-D25BNPTW.js';
-export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, updateFromCatalog } from './chunk-D25BNPTW.js';
+import { defaultCatalogs } from './chunk-OAIAFXMS.js';
+import { stats, embed, edit, OPFApiError, asApiError } from './chunk-LLEXM7TQ.js';
+export { OPFApiError, OPFExportError, OPFImportError, OPFMoveToCustomError, copySlides, fill, fillRecords, localAssetSources, moveToCustom, parseSlideSelection, sameRecord, updateFromCatalog } from './chunk-LLEXM7TQ.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';
-import { paginate } from './chunk-77KL2PMM.js';
-export { OPFPaginationError, paginateSlide } from './chunk-77KL2PMM.js';
-export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-GIWNHRTX.js';
-export { fromMarkdown, toMarkdown } from './chunk-3S2XVDPN.js';
-import './chunk-VZBFQLCA.js';
+export { OPFDataImportError, ingest, parseTabularData } from './chunk-N77N4AOD.js';
+import { paginate } from './chunk-KXKN3W5Z.js';
+export { OPFPaginationError, paginateSlide } from './chunk-KXKN3W5Z.js';
+export { DECK_FORMATS, deckFormatOf, parse, stringify } from './chunk-BQUWRXTR.js';
+export { fromMarkdown, toMarkdown } from './chunk-MTFK7QEY.js';
+import './chunk-XZ23FORL.js';
+export { OPFFormatError, format } from './chunk-KELC4K62.js';
 import './chunk-RYZPBJLB.js';
-export { explain } from './chunk-G5WJMJV3.js';
-import './chunk-H7XMO36O.js';
-import './chunk-PHP45MO7.js';
-export { OPFMarkdownError } from './chunk-Y4TZCE7R.js';
-import './chunk-Y25DYRME.js';
-export { diff, merge } from './chunk-A54NGT2K.js';
-import { validate, OPFValidationError } from './chunk-IVPA6NG6.js';
-export { CATALOG_SCHEMA, DEFAULT_VALIDATION_THRESHOLDS, OPFPatchError, OPFPatchValidationError, OPFValidationError, applyPatch, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, findValidationRule, resolveSlideContext, validateCatalogRecord, validationCategories, validationRules } from './chunk-IVPA6NG6.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 { explain } from './chunk-UOHWG4OS.js';
+import './chunk-PCU4XGKV.js';
+import './chunk-P6PKYJTS.js';
+export { OPFMarkdownError } from './chunk-SEZ4EPW6.js';
+import './chunk-TNUTRV6E.js';
+export { OPFIdError, assignIds, touches } from './chunk-CR72ZJ6W.js';
+export { diff, merge } from './chunk-VGGPAMP7.js';
+import { validate, OPFValidationError } from './chunk-WPKCWQ6W.js';
+export { CATALOG_SCHEMA, DEFAULT_VALIDATION_THRESHOLDS, OPFPatchError, OPFPatchHashError, OPFPatchValidationError, OPFValidationError, applyPatch, assertValid, assertValidCatalogRecord, catalogDisplayKinds, catalogSchemaNames, documentHash, findValidationRule, idToken, isIdToken, resolveDrawnFontFamilies, resolveIdPatch, resolveIdPointer, resolveSlideContext, toIdPatch, toIdPointer, validateCatalogRecord, validationCategories, validationRules } from './chunk-WPKCWQ6W.js';
+import './chunk-JBARNYFR.js';
+export { audience, chartType, colorScheme, fontScheme, language, layout, narrative, presentation, purpose, schemaEntries, schemaNames, schemas, socialPlatform, theme, tone } from './chunk-5Q4IYLMW.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-2CUCYENF.js';
+import './chunk-GM7WFPGG.js';
 
 // src/index.ts
 var withDefaultCatalog = (options) => {
@@ -33,7 +36,7 @@ var stats2 = (presentation2, options) => stats(presentation2, withDefaultCatalog
 var paginate2 = (input, options) => paginate(input, withDefaultCatalog(options));
 var embed2 = (document, options) => embed(document, withDefaultCatalog(options));
 var edit2 = (deck, patch, options) => edit(deck, patch, withDefaultCatalog(options));
-var engine = () => import('./conversion-IVKCKMCN.js');
+var engine = () => import('./conversion-XJTDWQ5W.js');
 var rethrow = (error, fallback) => {
   if (error instanceof OPFValidationError) throw error;
   throw asApiError(OPFApiError, error, fallback);

package/dist/markdown.d.ts

@@ -1,9 +1,9 @@
-import { a as Catalog } from './catalog-refs-BSfGELpt.js';
-import { P as Presentation } from './presentation-Bwo8Ko6D.js';
-import { a as Finding, b as FindingLocation } from './finding-l9dlQ2NF.js';
-import { a as ValidateOptions, V as ValidationReport } from './validation-types-3ARvTsB0.js';
-import './composition-DIftf6iP.js';
-import './chart-data-BnNqgnC-.js';
+import { Catalog } from './composition.js';
+import { Presentation } from './index.js';
+import { Finding, FindingLocation } from './index.js';
+import { ValidateOptions, ValidationReport } from './index.js';
+import './composition-C-hd_Ci3.js';
+import './chart-data-Ci9s_NDN.js';
 import './json-BFSdESOE.js';
 
 interface EmbeddedPart {
@@ -89,4 +89,5 @@ interface ToMarkdownResult {
  */
 declare function toMarkdown(document: unknown, options?: ToMarkdownOptions): ToMarkdownResult;
 
-export { type EmbeddedPart, type FromMarkdownOptions, type FromMarkdownResult, OPFMarkdownError, type ToMarkdownOptions, type ToMarkdownResult, fromMarkdown, toMarkdown };
+export { OPFMarkdownError, fromMarkdown, toMarkdown };
+export type { EmbeddedPart, FromMarkdownOptions, FromMarkdownResult, ToMarkdownOptions, ToMarkdownResult };

package/dist/markdown.js

@@ -1,9 +1,11 @@
-export { fromMarkdown, toMarkdown } from './chunk-3S2XVDPN.js';
+export { fromMarkdown, toMarkdown } from './chunk-MTFK7QEY.js';
 import './chunk-RYZPBJLB.js';
-import './chunk-H7XMO36O.js';
-import './chunk-PHP45MO7.js';
-export { OPFMarkdownError } from './chunk-Y4TZCE7R.js';
-import './chunk-Y25DYRME.js';
-import './chunk-IVPA6NG6.js';
-import './chunk-XRMV2GMB.js';
-import './chunk-F4HFDP6I.js';
+import './chunk-PCU4XGKV.js';
+import './chunk-P6PKYJTS.js';
+export { OPFMarkdownError } from './chunk-SEZ4EPW6.js';
+import './chunk-TNUTRV6E.js';
+import './chunk-WPKCWQ6W.js';
+import './chunk-JBARNYFR.js';
+import './chunk-5Q4IYLMW.js';
+import './chunk-2CUCYENF.js';
+import './chunk-GM7WFPGG.js';

package/dist/node-engine.d.ts

@@ -1,14 +1,14 @@
-export { b as DeckReport, c as DeckReportOptions, r as readDeckReport } from './deck-report-5vwMGcQz.js';
-import { F as FontsHandle, j as EmbeddedFace, R as Renderer, k as Reporter, P as Peer, l as PptxModule, f as OPFApiError } from './conversion-ChmGA8Ul.js';
-export { m as ConversionPlan, D as Diagnostic, n as EXPORT_FORMATS, o as EXPORT_TEXT, q as ExportContext, r as ExportFile, s as ExportFontSummary, E as ExportFormat, t as ExportOptions, u as ExportResult, v as ExportRun, w as ExportText, I as ImportOptions, x as ImportResult, g as OPFExportError, h as OPFImportError, y as PEER_RANGES, z as PPTX_PACKAGE, A as PreparedExport, B as RENDER_EXTRAS, G as RENDER_PACKAGE, H as ReportFinding, J as ResolvedExportOptions, i as SlideSelection, K as Source, V as VERSIONS, L as asApiError, M as assetRoot, N as checkDate, Q as checkOptions, T as checkRenamedOptions, U as checkScale, W as deckFileFormat, X as exportFormatOf, Y as finishReport, Z as importPresentation, _ as loadPptx, $ as loadRenderer, a0 as locatePackage, a1 as missingPeerFrom, p as parseSlideSelection, a2 as planConversion, a3 as prepareExport, a4 as reaches, a5 as readInput, a6 as reportThrown, a7 as resolveExportOptions, a8 as runExport, a9 as runPreparedExport, aa as writePlanned } from './conversion-ChmGA8Ul.js';
-import { a as Catalog } from './catalog-refs-BSfGELpt.js';
-import { e as PresentationPaginationResult } from './pagination-D_kJe4jH.js';
-import './presentation-Bwo8Ko6D.js';
-import './validation-types-3ARvTsB0.js';
-import './composition-DIftf6iP.js';
-import './chart-data-BnNqgnC-.js';
+export { b as DeckReport, c as DeckReportOptions, r as readDeckReport } from './deck-report-DQMsvyBI.js';
+import { F as FontsHandle, E as EmbeddedFace, R as Renderer, a as Reporter, P as Peer, b as PptxModule, O as OPFApiError } from './conversion-hbZeS5kD.js';
+export { C as ConversionPlan, D as Diagnostic, c as EXPORT_FORMATS, d as EXPORT_TEXT, e as ExportContext, f as ExportFile, g as ExportFontSummary, h as ExportFormat, i as ExportOptions, j as ExportResult, k as ExportRun, l as ExportText, I as ImportOptions, m as ImportResult, n as OPFExportError, o as OPFImportError, p as PEER_RANGES, q as PPTX_PACKAGE, r as PreparedExport, s as RENDER_EXTRAS, t as RENDER_PACKAGE, u as ReportFinding, v as ResolvedExportOptions, S as SlideSelection, w as Source, V as VERSIONS, x as asApiError, y as assetRoot, z as checkDate, A as checkOptions, B as checkRenamedOptions, G as checkScale, H as deckFileFormat, J as exportFormatOf, K as finishReport, L as importPresentation, M as loadPptx, N as loadRenderer, Q as locatePackage, T as missingPeerFrom, U as parseSlideSelection, W as planConversion, X as prepareExport, Y as reaches, Z as readInput, _ as reportThrown, $ as resolveExportOptions, a0 as runExport, a1 as runPreparedExport, a2 as writePlanned } from './conversion-hbZeS5kD.js';
+import { Catalog } from './composition.js';
+import { Fonts } from './composition.js';
+import { PresentationPaginationResult } from './index.js';
+import './presentation-8jLSTFqL.js';
+import './validation-types-mNmfcY9A.js';
 import './finding-l9dlQ2NF.js';
 import './json-BFSdESOE.js';
+import './chart-data-Ci9s_NDN.js';
 
 /** `deck.opf.json` and `deck.pptx` both give `deck`; stdin gives `deck`. */
 declare function stemOf(input: string): string;
@@ -144,10 +144,33 @@ interface PaginatedDeck {
  * `fontFolders` the fonts are required, so a missing renderer throws. Throws `OPFPaginationError` when content cannot fit.
  */
 declare function paginateDeck(deck: unknown, options: PaginateDeckOptions): Promise<PaginatedDeck>;
+interface MeasuringFontsOptions {
+    /** Folders of `.ttf` and `.otf` files, loaded before the bundled pack (as `--fonts`). They need opf-render. */
+    fontFolders?: readonly string[];
+    /** Receives the font diagnostics. */
+    reporter: Reporter;
+    /** Name options as the command's flags in messages. */
+    flags?: boolean;
+}
+interface MeasuringFonts {
+    /** The fonts `opf convert` draws `deck` with; absent when the layout can only be estimated. */
+    fonts?: Fonts;
+    /** Why there are no fonts: the missing or too old peer (`peer-not-installed`, `peer-too-old`) that measuring needs. */
+    estimated?: OPFApiError;
+    /** Returns a shared handle; call it when the measurement is done. */
+    release(): void;
+}
+/**
+ * The fonts the CLI measures a deck with (`opf paginate`, `opf validate`; WI-1, P24): opf-render's office pack, prepared once per
+ * process and shared, plus any `fontFolders`, as `opf convert` draws. Without opf-render (or with one too old) the result has no
+ * fonts and says why in `estimated`. With `fontFolders` the fonts are required, so a missing renderer throws.
+ */
+declare function measuringFonts(deck: unknown, options: MeasuringFontsOptions): Promise<MeasuringFonts>;
 
 /** Why a gallery that declares `declared` cannot be the default catalog of a core that reads `reads`, or undefined when it can. */
 declare function galleryMismatch(declared: unknown, reads?: number): string | undefined;
 /** The catalogs a call registers when it names none: `[gallery]`. Throws `gallery-schema-mismatch` for a gallery of another schema. */
 declare function defaultCatalogs(): readonly Catalog[];
 
-export { type AssetProblem, FontsHandle, type ImportRun, OPFApiError, type PaginateDeckOptions, type PaginatedDeck, Peer, type PlannedFile, PptxModule, Renderer, Reporter, checkDestinations, checkOutputPattern, createZip, deckStem, defaultCatalogs, embeddedFor, galleryMismatch, leaseSharedFonts, listFontDirectories, localAssetProblems, padNumber, paginateDeck, pointerOf, prepareFonts, publishNew, runImport, stemOf, writeFiles };
+export { FontsHandle, OPFApiError, Peer, PptxModule, Renderer, Reporter, checkDestinations, checkOutputPattern, createZip, deckStem, defaultCatalogs, embeddedFor, galleryMismatch, leaseSharedFonts, listFontDirectories, localAssetProblems, measuringFonts, padNumber, paginateDeck, pointerOf, prepareFonts, publishNew, runImport, stemOf, writeFiles };
+export type { AssetProblem, ImportRun, MeasuringFonts, MeasuringFontsOptions, PaginateDeckOptions, PaginatedDeck, PlannedFile };

package/dist/node-engine.js

@@ -1,45 +1,54 @@
-import { loadRenderer, listFontDirectories, leaseSharedFonts, prepareFonts } from './chunk-L52N5FZZ.js';
-export { EXPORT_FORMATS, EXPORT_TEXT, PEER_RANGES, PPTX_PACKAGE, RENDER_EXTRAS, RENDER_PACKAGE, Reporter, VERSIONS, assetRoot, checkDate, checkDestinations, checkOptions, checkOutputPattern, checkRenamedOptions, checkScale, createZip, deckFileFormat, deckStem, embeddedFor, exportFormatOf, finishReport, importPresentation, leaseSharedFonts, listFontDirectories, loadPptx, loadRenderer, localAssetProblems, locatePackage, missingPeerFrom, padNumber, planConversion, pointerOf, prepareExport, prepareFonts, publishNew, reaches, readInput, reportThrown, resolveExportOptions, runExport, runImport, runPreparedExport, stemOf, writeFiles, writePlanned } from './chunk-L52N5FZZ.js';
-import { defaultCatalogs } from './chunk-NVT2YDVC.js';
-export { defaultCatalogs, galleryMismatch } from './chunk-NVT2YDVC.js';
-import { OPFApiError } from './chunk-D25BNPTW.js';
-export { OPFApiError, OPFExportError, OPFImportError, asApiError, parseSlideSelection } from './chunk-D25BNPTW.js';
+import { loadRenderer, listFontDirectories, leaseSharedFonts, prepareFonts } from './chunk-F6DCEGB3.js';
+export { EXPORT_FORMATS, EXPORT_TEXT, PEER_RANGES, PPTX_PACKAGE, RENDER_EXTRAS, RENDER_PACKAGE, Reporter, VERSIONS, assetRoot, checkDate, checkDestinations, checkOptions, checkOutputPattern, checkRenamedOptions, checkScale, createZip, deckFileFormat, deckStem, embeddedFor, exportFormatOf, finishReport, importPresentation, leaseSharedFonts, listFontDirectories, loadPptx, loadRenderer, localAssetProblems, locatePackage, missingPeerFrom, padNumber, planConversion, pointerOf, prepareExport, prepareFonts, publishNew, reaches, readInput, reportThrown, resolveExportOptions, runExport, runImport, runPreparedExport, stemOf, writeFiles, writePlanned } from './chunk-F6DCEGB3.js';
+import { defaultCatalogs } from './chunk-OAIAFXMS.js';
+export { defaultCatalogs, galleryMismatch } from './chunk-OAIAFXMS.js';
+import { OPFApiError } from './chunk-LLEXM7TQ.js';
+export { OPFApiError, OPFExportError, OPFImportError, asApiError, parseSlideSelection } from './chunk-LLEXM7TQ.js';
 import './chunk-UJSAR6GF.js';
 import './chunk-PJSPHHRK.js';
-import './chunk-TKQ2VFV5.js';
-import { paginate } from './chunk-77KL2PMM.js';
-export { readDeckReport } from './chunk-GIWNHRTX.js';
-import './chunk-3S2XVDPN.js';
-import './chunk-VZBFQLCA.js';
+import './chunk-N77N4AOD.js';
+import { paginate } from './chunk-KXKN3W5Z.js';
+export { readDeckReport } from './chunk-BQUWRXTR.js';
+import './chunk-MTFK7QEY.js';
+import './chunk-XZ23FORL.js';
+import './chunk-KELC4K62.js';
 import './chunk-RYZPBJLB.js';
-import './chunk-G5WJMJV3.js';
-import './chunk-H7XMO36O.js';
-import './chunk-PHP45MO7.js';
-import './chunk-Y4TZCE7R.js';
-import './chunk-Y25DYRME.js';
-import './chunk-A54NGT2K.js';
-import './chunk-IVPA6NG6.js';
-import './chunk-XRMV2GMB.js';
-import './chunk-EQ6S5SEZ.js';
-import './chunk-F4HFDP6I.js';
+import './chunk-UOHWG4OS.js';
+import './chunk-PCU4XGKV.js';
+import './chunk-P6PKYJTS.js';
+import './chunk-SEZ4EPW6.js';
+import './chunk-TNUTRV6E.js';
+import './chunk-CR72ZJ6W.js';
+import './chunk-VGGPAMP7.js';
+import './chunk-WPKCWQ6W.js';
+import './chunk-JBARNYFR.js';
+import './chunk-5Q4IYLMW.js';
+import './chunk-2CUCYENF.js';
+import './chunk-GM7WFPGG.js';
 
 // src/node/paginate.ts
 async function paginateDeck(deck, options) {
   const catalogs = options.catalogs ?? defaultCatalogs();
+  const measuring = await measuringFonts(deck, options);
+  try {
+    return { result: paginate(deck, { ...measuring.fonts ? { fonts: measuring.fonts } : {}, catalogs }), ...measuring.estimated ? { estimated: measuring.estimated } : {} };
+  } finally {
+    measuring.release();
+  }
+}
+async function measuringFonts(deck, options) {
   const folders = options.fontFolders ?? [];
-  let lease;
   try {
     const renderer = await loadRenderer();
     const userFonts = await listFontDirectories([...folders], options.flags ? "--fonts" : "fonts");
-    lease = await leaseSharedFonts(renderer, deck, userFonts, options.reporter);
+    const lease = await leaseSharedFonts(renderer, deck, userFonts, options.reporter);
     const handle = lease?.handle ?? (await prepareFonts(renderer, deck, userFonts, options.reporter)).handle;
-    return { result: paginate(deck, { fonts: handle, catalogs }) };
+    return { fonts: handle, release: () => lease?.release() };
   } catch (error) {
-    if (error instanceof OPFApiError && (error.code === "peer-not-installed" || error.code === "peer-too-old") && !folders.length) return { result: paginate(deck, { catalogs }), estimated: error };
+    if (error instanceof OPFApiError && (error.code === "peer-not-installed" || error.code === "peer-too-old") && !folders.length) return { estimated: error, release: () => {
+    } };
     throw error;
-  } finally {
-    lease?.release();
   }
 }
 
-export { paginateDeck };
+export { measuringFonts, paginateDeck };

package/dist/{pagination-D_kJe4jH.d.ts → pagination-DyAKYpXu.d.ts}

@@ -1,5 +1,5 @@
-import { C as ComposeSlideOptions, R as ResolvedColorRoles, F as Fonts, L as LayoutDiagnostic } from './composition-DIftf6iP.js';
-import { U as UnresolvedReferenceDiagnostic, R as RecordProvenance, b as CatalogOptions, a as Catalog } from './catalog-refs-BSfGELpt.js';
+import { C as ComposeSlideOptions, R as ResolvedColorRoles, F as Fonts, L as LayoutDiagnostic } from './composition-C-hd_Ci3.js';
+import { U as UnresolvedReferenceDiagnostic, R as RecordProvenance, b as CatalogOptions, C as Catalog } from './catalog-refs-kAefsZWT.js';
 
 /**
  * One slide's composition context: the layout, canvas, theme and font families that `composeSlide` needs,
@@ -135,4 +135,5 @@ interface PresentationPaginationResult {
 /** Resolve the slides' references (the document's catalogs groups, then the registered catalogs) and paginate a complete presentation without mutating it. */
 declare function paginate(input: unknown, options?: PresentationPaginationOptions): PresentationPaginationResult;
 
-export { OPFPaginationError as O, type PaginatedPage as P, type SlideContext as S, type PresentationPaginationOptions as a, type PaginationMapping as b, type PaginationOptions as c, type PaginationResult as d, type PresentationPaginationResult as e, type SlideContextDiagnostic as f, type SlideContextOptions as g, paginateSlide as h, paginate as p, resolveSlideContext as r };
+export { OPFPaginationError as O, paginateSlide as h, paginate as p, resolveSlideContext as r };
+export type { PaginatedPage as P, SlideContext as S, PresentationPaginationOptions as a, PresentationPaginationResult as b, PaginationMapping as c, PaginationOptions as d, PaginationResult as e, SlideContextDiagnostic as f, SlideContextOptions as g };

package/dist/pagination.d.ts

@@ -1,4 +1,4 @@
-import './composition-DIftf6iP.js';
-import './catalog-refs-BSfGELpt.js';
-export { O as OPFPaginationError, P as PaginatedPage, b as PaginationMapping, c as PaginationOptions, d as PaginationResult, a as PresentationPaginationOptions, e as PresentationPaginationResult, p as paginate, h as paginateSlide } from './pagination-D_kJe4jH.js';
-import './chart-data-BnNqgnC-.js';
+import './composition-C-hd_Ci3.js';
+import './catalog-refs-kAefsZWT.js';
+export { O as OPFPaginationError, P as PaginatedPage, c as PaginationMapping, d as PaginationOptions, e as PaginationResult, a as PresentationPaginationOptions, b as PresentationPaginationResult, p as paginate, h as paginateSlide } from './pagination-DyAKYpXu.js';
+import './chart-data-Ci9s_NDN.js';

package/dist/pagination.js

@@ -1,4 +1,6 @@
-export { OPFPaginationError, paginate, paginateSlide } from './chunk-77KL2PMM.js';
-import './chunk-IVPA6NG6.js';
-import './chunk-XRMV2GMB.js';
-import './chunk-F4HFDP6I.js';
+export { OPFPaginationError, paginate, paginateSlide } from './chunk-KXKN3W5Z.js';
+import './chunk-WPKCWQ6W.js';
+import './chunk-JBARNYFR.js';
+import './chunk-5Q4IYLMW.js';
+import './chunk-2CUCYENF.js';
+import './chunk-GM7WFPGG.js';

package/dist/patch.d.ts

@@ -1,7 +1,16 @@
-import { F as FindingReport, a as Finding, J as JsonPatchOperation } from './finding-l9dlQ2NF.js';
+import { J as JsonPatchOperation } from './finding-l9dlQ2NF.js';
+import { FindingReport, Finding } from './index.js';
+
+/**
+ * The content hash of a document: `sha256:` and the SHA-256 of its canonical JSON (members sorted at every depth), as 64 lowercase
+ * hex digits. It is the same in Node, browsers and edge runtimes, does not depend on key order or on the file form the document was
+ * read from, and changes with any change of content, including the order of arrays. Pass it as `expectHash` to `applyPatch` or `edit`
+ * to apply a patch only to the document it was made for.
+ */
+declare function documentHash(document: unknown): string;
 
 type JsonPointer = string;
-type PatchErrorCode = "invalid-patch" | "invalid-patch-operation" | "unsupported-patch-operation" | "invalid-json-pointer" | "patch-path-missing" | "patch-parent-missing" | "invalid-array-index" | "patch-test-failed" | "patch-invalid-move" | "patch-root-remove" | "patch-invalid-document";
+type PatchErrorCode = "invalid-patch" | "invalid-patch-operation" | "unsupported-patch-operation" | "invalid-json-pointer" | "patch-path-missing" | "patch-parent-missing" | "invalid-array-index" | "patch-test-failed" | "patch-invalid-move" | "patch-root-remove" | "patch-invalid-document" | "patch-id-not-found" | "patch-id-ambiguous" | "invalid-expect-hash" | "patch-hash-mismatch";
 declare class OPFPatchError extends Error {
     readonly code: PatchErrorCode;
     /** The JSON Pointer the failing operation addressed, when known. */
@@ -21,6 +30,17 @@ declare class OPFPatchValidationError extends OPFPatchError {
     readonly validation: PatchValidationResult;
     constructor(validation: PatchValidationResult);
 }
+/**
+ * Thrown when `expectHash` is given and the document is not the one the patch was made for (`code` `patch-hash-mismatch`): it changed
+ * since the hash was taken. Nothing was applied. Read the document again, rebase the edit, and retry with the new hash.
+ */
+declare class OPFPatchHashError extends OPFPatchError {
+    /** The hash the caller expected, in the form `documentHash` returns. */
+    readonly expected: string;
+    /** The hash of the document the patch was given. */
+    readonly actual: string;
+    constructor(expected: string, actual: string);
+}
 /** What a validator hook returns: a `validate` report, or anything with `valid` (and `findings` for `strict` to read). */
 interface PatchValidationResult extends Pick<FindingReport, "valid"> {
     findings?: Finding[];
@@ -34,6 +54,12 @@ interface ApplyPatchOptions {
     validate?: boolean | ((document: unknown) => PatchValidationResult);
     /** With `validate`, also reject warnings. */
     strict?: boolean;
+    /**
+     * Apply the patch only to the document it was made for: the `documentHash` of the input. A different document throws
+     * `OPFPatchHashError` (`patch-hash-mismatch`) before anything is applied; a value that is not a hash throws `invalid-expect-hash`.
+     * The bare 64-digit hex form is accepted. This is optimistic concurrency for a server that holds the document.
+     */
+    expectHash?: string;
 }
 interface PatchResult {
     /** The patched presentation (a clone; the input is never changed). */
@@ -63,7 +89,25 @@ declare function splitPointer(pointer: JsonPointer): {
     parent: JsonPointer;
     token: string;
 };
-/** Read a value without throwing: `found` is false for a missing path (including `-` and bad indices). */
+/** True for a token that names an array element by id (`@intro`). */
+declare const isIdToken: (token: string) => boolean;
+/** The pointer token that names the array element with this id (`intro` gives `@intro`). Escape it with `escapePointerToken` or `formatPointer`. */
+declare const idToken: (id: string) => string;
+/**
+ * The index form of a pointer: every id token (`/slides/@intro/title`) replaced by the index of the element in `document`
+ * (`/slides/2/title`). A pointer without id tokens is returned as written; nothing else is checked, so a path that does not exist
+ * is not an error. Throws `patch-id-not-found` for an id no element has and `patch-id-ambiguous` for an id several elements share.
+ */
+declare function resolveIdPointer(document: unknown, pointer: JsonPointer): JsonPointer;
+/**
+ * The id form of an index pointer: every array index whose element has a unique, non-empty string `id` becomes `@id`
+ * (`/slides/2/blocks/0` gives `/slides/@intro/blocks/@kpi`); indexes of elements without an id stay. Id tokens in the pointer are kept.
+ * Pass an index into an array as the last token of an insertion (`add`) with `{ keepLast: true }` to leave it as written.
+ */
+declare function toIdPointer(document: unknown, pointer: JsonPointer, options?: {
+    keepLast?: boolean;
+}): JsonPointer;
+/** Read a value without throwing: `found` is false for a missing path (including `-` and bad indices). An id token (`@intro`) finds the array element with that id. */
 declare function readPointer(document: unknown, pointer: JsonPointer | readonly string[]): {
     found: true;
     value: unknown;
@@ -75,6 +119,32 @@ declare function getAtPointer(document: unknown, pointer: JsonPointer | readonly
 declare const hasPointer: (document: unknown, pointer: JsonPointer | readonly string[]) => boolean;
 /** Normalise and structurally validate a patch (shape only; no document needed). Values are cloned. */
 declare function normalizePatch(patch: unknown): JsonPatchOperation[];
+/** One applied operation, as `walkPatch` reports it. */
+interface PatchStep {
+    /** The index of the operation within the patch. */
+    index: number;
+    /** The normalized operation as given (id tokens as written). */
+    operation: JsonPatchOperation;
+    /** The same operation with id tokens resolved to indexes in the document it applied to (an `add` at `-` carries the index it appended at). */
+    resolved: JsonPatchOperation;
+    /** The patch that undoes this operation, in application order. */
+    inverse: JsonPatchOperation[];
+}
+/**
+ * Apply `patch` to a clone of `document` one operation at a time and tell the hooks about each: `before` sees the document an
+ * operation is about to change, `after` the document it produced. The documents are the working copy, shared between calls: read them,
+ * never keep or change them. Errors are those of `applyPatch`, with the operation's index. This is the one loop under
+ * `applyPatchWithInverse`, `resolveIdPatch`, `toIdPatch` and `touches`; most callers want one of them.
+ * @returns the patched clone.
+ */
+declare function walkPatch(document: unknown, patch: unknown, hooks?: {
+    before?: (index: number, operation: JsonPatchOperation, working: unknown) => void;
+    after?: (step: PatchStep, working: unknown) => void;
+}): {
+    document: unknown;
+    operations: JsonPatchOperation[];
+    inverse: JsonPatchOperation[];
+};
 /**
  * Apply a patch to a clone of `document` and return the result with its
  * inverse. Atomic: any failing operation throws and nothing is returned.
@@ -84,5 +154,20 @@ declare function applyPatchWithInverse(document: unknown, patch: unknown, option
 declare function applyPatch(document: unknown, patch: unknown, options?: ApplyPatchOptions): unknown;
 /** The patch that undoes `patch` when applied to the result of `applyPatch(document, patch)`. */
 declare function invertPatch(document: unknown, patch: unknown): JsonPatchOperation[];
+/**
+ * The patch with every id token resolved to the index it has when the operation runs: `/slides/@intro/title` becomes `/slides/2/title`,
+ * operation by operation, so an earlier operation that moves a slide is accounted for. A path in the destination of `move` resolves
+ * after the value has left. Throws what `applyPatch` throws (`patch-id-not-found`, ...). Use it to hand an id-addressed patch to a tool
+ * that reads indexes.
+ */
+declare function resolveIdPatch(document: unknown, patch: unknown): JsonPatchOperation[];
+/**
+ * The patch with every index that names an element with an `id` written as the id token (`/slides/2/title` becomes
+ * `/slides/@intro/title`), operation by operation against the document each operation applies to. Where an operation inserts
+ * (`add`, `copy` and `move` destinations), the last token stays an index (or `-`): there is no element yet to name. The id form survives
+ * reordering, so a host that syncs by id sends it; `applyPatch` accepts it. Elements without an id keep their indexes.
+ */
+declare function toIdPatch(document: unknown, patch: unknown): JsonPatchOperation[];
 
-export { type ApplyPatchOptions, JsonPatchOperation, type JsonPointer, OPFPatchError, OPFPatchValidationError, type PatchErrorCode, type PatchResult, type PatchValidationResult, applyPatch, applyPatchWithInverse, escapePointerToken, formatPointer, getAtPointer, hasPointer, invertPatch, jsonEqual, normalizePatch, parsePointer, pointerFromPath, readPointer, splitPointer, unescapePointerToken };
+export { JsonPatchOperation, OPFPatchError, OPFPatchHashError, OPFPatchValidationError, applyPatch, applyPatchWithInverse, documentHash, escapePointerToken, formatPointer, getAtPointer, hasPointer, idToken, invertPatch, isIdToken, jsonEqual, normalizePatch, parsePointer, pointerFromPath, readPointer, resolveIdPatch, resolveIdPointer, splitPointer, toIdPatch, toIdPointer, unescapePointerToken, walkPatch };
+export type { ApplyPatchOptions, JsonPointer, PatchErrorCode, PatchResult, PatchStep, PatchValidationResult };

package/dist/patch.js

@@ -1,3 +1,5 @@
-export { OPFPatchError, OPFPatchValidationError, applyPatch, applyPatchWithInverse, escapePointerToken, formatPointer, getAtPointer, hasPointer, invertPatch, jsonEqual, normalizePatch, parsePointer, pointerFromPath, readPointer, splitPointer, unescapePointerToken } from './chunk-IVPA6NG6.js';
-import './chunk-XRMV2GMB.js';
-import './chunk-F4HFDP6I.js';
+export { OPFPatchError, OPFPatchHashError, OPFPatchValidationError, applyPatch, applyPatchWithInverse, documentHash, escapePointerToken, formatPointer, getAtPointer, hasPointer, idToken, invertPatch, isIdToken, jsonEqual, normalizePatch, parsePointer, pointerFromPath, readPointer, resolveIdPatch, resolveIdPointer, splitPointer, toIdPatch, toIdPointer, unescapePointerToken, walkPatch } from './chunk-WPKCWQ6W.js';
+import './chunk-JBARNYFR.js';
+import './chunk-5Q4IYLMW.js';
+import './chunk-2CUCYENF.js';
+import './chunk-GM7WFPGG.js';

package/dist/precompiled.d.ts

@@ -0,0 +1,2 @@
+
+export { };

package/dist/precompiled.js

@@ -0,0 +1,7 @@
+import { installSchemaEngine } from './chunk-43JWUIGF.js';
+import { schemaEngine } from './chunk-ZROVYWGU.js';
+import './chunk-5Q4IYLMW.js';
+import './chunk-GM7WFPGG.js';
+
+// src/precompiled.ts
+installSchemaEngine(schemaEngine());