@stll/folio-core 0.62.0 → 0.63.1

package/dist/docx/preservedRunContent.d.ts

@@ -6,7 +6,7 @@ import { XmlElement } from "./xmlParser.js";
  * nothing. Unknown markup contributes nothing on purpose: guessing at the text
  * of an element folio has never seen would put invented words in a document.
  */
-declare const preservedRunChildText: (element: XmlElement) => string;
+export declare const preservedRunChildText: (element: XmlElement) => string;
 /**
  * Capture one unmodelled run child.
  *
@@ -16,7 +16,7 @@ declare const preservedRunChildText: (element: XmlElement) => string;
  * prefix still arrives bound. Copying the whole root scope onto the fragment
  * instead would rewrite every capture with declarations it does not use.
  */
-declare const preserveRunChild: (element: XmlElement) => document_d_exports.PreservedXmlContent;
+export declare const preserveRunChild: (element: XmlElement) => document_d_exports.PreservedXmlContent;
 /**
  * One capture from the shared dispatcher's sink, as a member of the
  * container's own inline union.
@@ -25,8 +25,7 @@ declare const preserveRunChild: (element: XmlElement) => document_d_exports.Pres
  * so nothing is known about it beyond its bytes: `text` is empty because a
  * name folio has never seen shows nothing folio can read.
  */
-declare const preservedInlineCapture: (xml: string) => document_d_exports.PreservedInline;
+export declare const preservedInlineCapture: (xml: string) => document_d_exports.PreservedInline;
 /** Capture one unmodelled inline child of a paragraph or an inline wrapper. */
-declare const preserveInlineChild: (element: XmlElement) => document_d_exports.PreservedInline;
-//#endregion
-export { preserveInlineChild, preserveRunChild, preservedInlineCapture, preservedRunChildText };
+export declare const preserveInlineChild: (element: XmlElement) => document_d_exports.PreservedInline;
+//#endregion

package/dist/docx/preservedRunContent.js

@@ -3,6 +3,22 @@ import { captureVerbatimXml } from "./verbatimCapture.js";
 import { findChildrenByLocalName, getChildElements, getLocalName, getTextContent } from "./xmlParser.js";
 //#region src/docx/preservedRunContent.ts
 /**
+* The run-level arm of the verbatim sink.
+*
+* `parseRunContents` recognises the run children folio models and used to let
+* the rest fall off the end of its switch. That is not merely a loss: the keep
+* rule in `paragraphParser` asks the *source* element whether a run carried a
+* payload while `serializeRun` writes the *model*, so an unmodelled child makes
+* the two disagree for exactly one save — save 1 emits a run with nothing in
+* it, the next parse drops that run, and save 2 differs from save 1. Holding
+* the markup turns the whole class into a fixed point at once.
+*
+* A preserved child is opaque everywhere except text: `w:ruby` puts its
+* `w:rubyBase` on the line as the word a reader reads, so the sink carries the
+* visible text alongside the markup and text extraction, markdown and layout
+* keep working.
+*/
+/**
 * Where a preserved run child hides text a reader sees, by local name: the
 * child elements whose `w:t` descendants are on the line rather than above,
 * beside, or nowhere.

package/dist/docx/previewBudget.d.ts

@@ -50,7 +50,7 @@ type SourceBackedKindName = { [Name in PreviewKindName]: (typeof PREVIEW_KINDS)[
  * Only a source-backed kind has an allowance: there is no number that would
  * change what the budget does to a descriptor.
  */
-type PreviewBudgetOverrides = Partial<Record<SourceBackedKindName, number>>;
+export type PreviewBudgetOverrides = Partial<Record<SourceBackedKindName, number>>;
 /**
  * Everything a preview image states except what the ledger stamps on it: its
  * geometry, wrap, position and names. A preview has no relationship behind
@@ -58,7 +58,7 @@ type PreviewBudgetOverrides = Partial<Record<SourceBackedKindName, number>>;
  */
 type PreviewFrame = Omit<document_d_exports.Image, "type" | "rId" | "src" | "mimeType" | "filename">;
 /** The one way a producer builds a preview image. */
-type PreviewLedger = {
+export type PreviewLedger = {
   /**
    * Build a `kind` preview that draws `svg` over `frame`, registered against
    * the package's allowance for that kind.
@@ -71,7 +71,7 @@ type PreviewLedger = {
   readonly release: (discarded: unknown) => void;
 };
 /** One parse's ledger, and the budget that charges it. */
-type PackagePreviewBudget = {
+export type PackagePreviewBudget = {
   readonly ledger: PreviewLedger;
   /**
    * Charge every registered preview against its kind's allowance and drop the
@@ -97,11 +97,11 @@ type PackagePreviewBudget = {
  * retaining more than the cap; the budget's tests pin that a package's ledger
  * holds exactly the previews its model carries.
  */
-declare const createPackagePreviewBudget: () => PackagePreviewBudget;
+export declare const createPackagePreviewBudget: () => PackagePreviewBudget;
 /**
  * A ledger for a read that builds no package: one part parsed on its own,
  * whose previews no package budget charges.
  */
-declare const standalonePreviewLedger: () => PreviewLedger;
+export declare const standalonePreviewLedger: () => PreviewLedger;
 //#endregion
-export { PackagePreviewBudget, PreviewBudgetOverrides, PreviewLedger, createPackagePreviewBudget, standalonePreviewLedger };
+export {};

package/dist/docx/previewBudget.js

@@ -5,7 +5,7 @@ const SVG_PREVIEW_DATA_URL_PREFIX = "data:image/svg+xml;charset=utf-8,";
 * Eight times what a producer may spend on one drawing, which is a package
 * holding a handful of the largest previews folio will build.
 */
-const SVG_PREVIEW_PACKAGE_CHARACTERS = 8 * (1024 * 1024);
+const SVG_PREVIEW_PACKAGE_CHARACTERS = 8388608;
 const PREVIEW_KINDS = {
 	/** A VML shape folio renders rather than projects (`v:shape`, `v:rect`, ...). */
 	vmlShape: {

package/dist/docx/propertyElementAttributes.d.ts

@@ -40,12 +40,12 @@
  * so a field that has no attribute to name has to say so with an empty list
  * rather than by being absent.
  */
-type ModelledAttributes<Field extends string> = Readonly<Record<Field, string | readonly string[]>>;
+export type ModelledAttributes<Field extends string> = Readonly<Record<Field, string | readonly string[]>>;
 /**
  * `w:ind`. `hangingIndent` is the sign of `indentFirstLine` rather than a
  * value of its own, so both name the attribute pair that carries it.
  */
-declare const INDENTATION_ATTRIBUTES: {
+export declare const INDENTATION_ATTRIBUTES: {
   readonly indentLeft: readonly ["left", "start"];
   readonly indentRight: readonly ["right", "end"];
   readonly indentFirstLine: readonly ["firstLine", "hanging"];
@@ -55,7 +55,7 @@ declare const INDENTATION_ATTRIBUTES: {
  * `w:spacing`. `spacingExplicit` records which of the two sides the paragraph
  * stated itself; it is derived from them and reads no attribute of its own.
  */
-declare const SPACING_ATTRIBUTES: {
+export declare const SPACING_ATTRIBUTES: {
   readonly spaceBefore: "before";
   readonly spaceAfter: "after";
   readonly lineSpacing: "line";
@@ -64,7 +64,7 @@ declare const SPACING_ATTRIBUTES: {
   readonly afterAutospacing: "afterAutospacing";
   readonly spacingExplicit: readonly [];
 };
-declare const FRAME_ATTRIBUTES: {
+export declare const FRAME_ATTRIBUTES: {
   readonly dropCap: "dropCap";
   readonly lines: "lines";
   readonly width: "w";
@@ -79,7 +79,7 @@ declare const FRAME_ATTRIBUTES: {
   readonly yAlign: "yAlign";
   readonly wrap: "wrap";
 };
-declare const TAB_STOP_ATTRIBUTES: {
+export declare const TAB_STOP_ATTRIBUTES: {
   readonly position: "pos";
   readonly alignment: "val";
   readonly leader: "leader";
@@ -89,7 +89,7 @@ declare const TAB_STOP_ATTRIBUTES: {
  * namespace; the remainder decides on the local name, so naming them here
  * keeps a `r:topLeft` out of it.
  */
-declare const BORDER_ATTRIBUTES: {
+export declare const BORDER_ATTRIBUTES: {
   readonly style: "val";
   readonly color: readonly ["color", "themeColor", "themeTint", "themeShade"];
   readonly size: "sz";
@@ -103,7 +103,7 @@ declare const BORDER_ATTRIBUTES: {
   readonly bottomRightArtRelationshipId: "bottomRight";
 };
 /** `CT_Shd`: direct, theme, modifier, and pattern attributes all have model fields. */
-declare const SHADING_ATTRIBUTES: {
+export declare const SHADING_ATTRIBUTES: {
   readonly color: readonly ["color", "themeColor", "themeTint", "themeShade"];
   readonly fill: readonly ["fill", "themeFill", "themeFillTint", "themeFillShade"];
   readonly pattern: "val";
@@ -117,7 +117,7 @@ declare const SHADING_ATTRIBUTES: {
  * is has to come from the model rather than from a list in the census. The
  * first entry is the one it picks.
  */
-declare const PROPERTY_ELEMENT_ATTRIBUTES: {
+export declare const PROPERTY_ELEMENT_ATTRIBUTES: {
   readonly CT_Ind: {
     readonly indentLeft: readonly ["left", "start"];
     readonly indentRight: readonly ["right", "end"];
@@ -173,6 +173,5 @@ declare const PROPERTY_ELEMENT_ATTRIBUTES: {
   };
 };
 /** Every attribute local name a table names, flattened, in field order. */
-declare const modelledAttributeNames: (modelled: ModelledAttributes<string>) => readonly string[];
-//#endregion
-export { BORDER_ATTRIBUTES, FRAME_ATTRIBUTES, INDENTATION_ATTRIBUTES, ModelledAttributes, PROPERTY_ELEMENT_ATTRIBUTES, SHADING_ATTRIBUTES, SPACING_ATTRIBUTES, TAB_STOP_ATTRIBUTES, modelledAttributeNames };
+export declare const modelledAttributeNames: (modelled: ModelledAttributes<string>) => readonly string[];
+//#endregion

package/dist/docx/rasterMime.d.ts

@@ -57,8 +57,8 @@ declare const RASTER_SIGNATURES: readonly [{
     readonly bytes: readonly [77, 77, 0, 43];
   }];
 }];
-type RasterMimeType = (typeof RASTER_SIGNATURES)[number]["mimeType"];
-declare const RASTER_MIME_TYPES: ReadonlySet<string>;
-declare const detectRasterMimeType: (data: ArrayBuffer) => RasterMimeType | undefined;
+export type RasterMimeType = (typeof RASTER_SIGNATURES)[number]["mimeType"];
+export declare const RASTER_MIME_TYPES: ReadonlySet<string>;
+export declare const detectRasterMimeType: (data: ArrayBuffer) => RasterMimeType | undefined;
 //#endregion
-export { RASTER_MIME_TYPES, RasterMimeType, detectRasterMimeType };
+export {};

package/dist/docx/relsParser.d.ts

@@ -4,7 +4,7 @@ import "../types/index.js";
 /**
  * Relationship type constants for common types
  */
-declare const RELATIONSHIP_TYPES: {
+export declare const RELATIONSHIP_TYPES: {
   readonly image: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
   readonly hyperlink: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink";
   readonly header: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header";
@@ -34,42 +34,42 @@ declare const RELATIONSHIP_TYPES: {
  * @param relsXml - XML content of a .rels file
  * @returns Map of relationship ID to Relationship object
  */
-declare function parseRelationships(relsXml: string): document_d_exports.RelationshipMap;
+export declare function parseRelationships(relsXml: string): document_d_exports.RelationshipMap;
 /**
  * Get the short type name from a full relationship type URI
  *
  * @param typeUri - Full relationship type URI
  * @returns Short type name (e.g., "image", "hyperlink") or "unknown"
  */
-declare function getRelationshipTypeName(typeUri: string): string;
+export declare function getRelationshipTypeName(typeUri: string): string;
 /**
  * Check if a relationship type is an external link (hyperlink)
  *
  * @param rel - Relationship to check
  * @returns true if this is an external hyperlink
  */
-declare function isExternalHyperlink(rel: document_d_exports.Relationship): boolean;
+export declare function isExternalHyperlink(rel: document_d_exports.Relationship): boolean;
 /**
  * Check if a relationship type is an image
  *
  * @param rel - Relationship to check
  * @returns true if this is an image relationship
  */
-declare function isImageRelationship(rel: document_d_exports.Relationship): boolean;
+export declare function isImageRelationship(rel: document_d_exports.Relationship): boolean;
 /**
  * Check if a relationship type is a header
  *
  * @param rel - Relationship to check
  * @returns true if this is a header relationship
  */
-declare function isHeaderRelationship(rel: document_d_exports.Relationship): boolean;
+export declare function isHeaderRelationship(rel: document_d_exports.Relationship): boolean;
 /**
  * Check if a relationship type is a footer
  *
  * @param rel - Relationship to check
  * @returns true if this is a footer relationship
  */
-declare function isFooterRelationship(rel: document_d_exports.Relationship): boolean;
+export declare function isFooterRelationship(rel: document_d_exports.Relationship): boolean;
 /**
  * Filter relationships by type
  *
@@ -77,35 +77,35 @@ declare function isFooterRelationship(rel: document_d_exports.Relationship): boo
  * @param type - Relationship type URI to filter by
  * @returns Array of matching relationships
  */
-declare function filterByType(map: document_d_exports.RelationshipMap, type: document_d_exports.RelationshipType): document_d_exports.Relationship[];
+export declare function filterByType(map: document_d_exports.RelationshipMap, type: document_d_exports.RelationshipType): document_d_exports.Relationship[];
 /**
  * Get all images from a relationship map
  *
  * @param map - RelationshipMap to search
  * @returns Array of image relationships
  */
-declare function getImages(map: document_d_exports.RelationshipMap): document_d_exports.Relationship[];
+export declare function getImages(map: document_d_exports.RelationshipMap): document_d_exports.Relationship[];
 /**
  * Get all hyperlinks from a relationship map
  *
  * @param map - RelationshipMap to search
  * @returns Array of hyperlink relationships
  */
-declare function getHyperlinks(map: document_d_exports.RelationshipMap): document_d_exports.Relationship[];
+export declare function getHyperlinks(map: document_d_exports.RelationshipMap): document_d_exports.Relationship[];
 /**
  * Get all headers from a relationship map
  *
  * @param map - RelationshipMap to search
  * @returns Array of header relationships
  */
-declare function getHeaders(map: document_d_exports.RelationshipMap): document_d_exports.Relationship[];
+export declare function getHeaders(map: document_d_exports.RelationshipMap): document_d_exports.Relationship[];
 /**
  * Get all footers from a relationship map
  *
  * @param map - RelationshipMap to search
  * @returns Array of footer relationships
  */
-declare function getFooters(map: document_d_exports.RelationshipMap): document_d_exports.Relationship[];
+export declare function getFooters(map: document_d_exports.RelationshipMap): document_d_exports.Relationship[];
 /**
  * What a relationship id names.
  *
@@ -114,7 +114,7 @@ declare function getFooters(map: document_d_exports.RelationshipMap): document_d
  * target the package no longer holds, and an id that resolves are different
  * facts, and only the last one may be read as a part.
  */
-type RelationshipResolution = {
+export type RelationshipResolution = {
   status: "resolved";
   relationship: document_d_exports.Relationship;
 } | {
@@ -130,7 +130,7 @@ type RelationshipResolution = {
  * An empty attribute is absence, not an id: `ST_RelationshipId` is an NCName,
  * so `""` can never name a relationship, and no map can hold it as a key.
  */
-declare function resolveRelationshipId(map: document_d_exports.RelationshipMap | null | undefined, rId: string | undefined): RelationshipResolution;
+export declare function resolveRelationshipId(map: document_d_exports.RelationshipMap | null | undefined, rId: string | undefined): RelationshipResolution;
 /**
  * Resolve a relationship id and require it to name a relationship of one type.
  *
@@ -138,7 +138,7 @@ declare function resolveRelationshipId(map: document_d_exports.RelationshipMap |
  * exists, but not as the thing the reference asked for, and reading it anyway
  * is how a missing image comes back as `styles.xml`.
  */
-declare function resolveRelationshipIdOfType(map: document_d_exports.RelationshipMap | null | undefined, rId: string | undefined, type: document_d_exports.RelationshipType): RelationshipResolution;
+export declare function resolveRelationshipIdOfType(map: document_d_exports.RelationshipMap | null | undefined, rId: string | undefined, type: document_d_exports.RelationshipType): RelationshipResolution;
 /**
  * Resolve a relative target path to an absolute path within the DOCX
  *
@@ -149,7 +149,7 @@ declare function resolveRelationshipIdOfType(map: document_d_exports.Relationshi
  * @param target - Relative target from the relationship
  * @returns Absolute path within the DOCX
  */
-declare function resolveRelativePath(basePath: string, target: string): string;
+export declare function resolveRelativePath(basePath: string, target: string): string;
 /**
  * Parse document.xml.rels specifically
  *
@@ -158,7 +158,7 @@ declare function resolveRelativePath(basePath: string, target: string): string;
  * @param relsXml - XML content of word/_rels/document.xml.rels
  * @returns RelationshipMap
  */
-declare function parseDocumentRelationships(relsXml: string): document_d_exports.RelationshipMap;
+export declare function parseDocumentRelationships(relsXml: string): document_d_exports.RelationshipMap;
 /**
  * Parse package-level .rels
  *
@@ -167,12 +167,11 @@ declare function parseDocumentRelationships(relsXml: string): document_d_exports
  * @param relsXml - XML content of _rels/.rels
  * @returns RelationshipMap
  */
-declare function parsePackageRelationships(relsXml: string): document_d_exports.RelationshipMap;
+export declare function parsePackageRelationships(relsXml: string): document_d_exports.RelationshipMap;
 /**
  * Debug: Print all relationships in a map
  *
  * @param map - RelationshipMap to print
  */
-declare function formatRelationships(map: document_d_exports.RelationshipMap): string;
-//#endregion
-export { RELATIONSHIP_TYPES, RelationshipResolution, filterByType, formatRelationships, getFooters, getHeaders, getHyperlinks, getImages, getRelationshipTypeName, isExternalHyperlink, isFooterRelationship, isHeaderRelationship, isImageRelationship, parseDocumentRelationships, parsePackageRelationships, parseRelationships, resolveRelationshipId, resolveRelationshipIdOfType, resolveRelativePath };
+export declare function formatRelationships(map: document_d_exports.RelationshipMap): string;
+//#endregion

package/dist/docx/removeHeaderFooterParts.d.ts

@@ -9,6 +9,6 @@ type RemoveResolvedHeaderFooterPartsOptions = {
   compressionLevel: number;
 };
 /** Remove only parts whose last selection was explicitly resolved out of the document. */
-declare const removeResolvedHeaderFooterParts: ({ document, zip, removedReferences, compressionLevel }: RemoveResolvedHeaderFooterPartsOptions) => Promise<void>;
+export declare const removeResolvedHeaderFooterParts: ({ document, zip, removedReferences, compressionLevel }: RemoveResolvedHeaderFooterPartsOptions) => Promise<void>;
 //#endregion
-export { removeResolvedHeaderFooterParts };
+export {};

package/dist/docx/renderedPageBreakNormalization.d.ts

@@ -7,6 +7,6 @@ type NormalizeRenderedPageBreakHintsInput = {
   footnotes?: readonly document_d_exports.Footnote[];
   endnotes?: readonly document_d_exports.Endnote[];
 };
-declare const normalizeRenderedPageBreakHints: ({ documentBody, headers, footers, footnotes, endnotes }: NormalizeRenderedPageBreakHintsInput) => void;
+export declare const normalizeRenderedPageBreakHints: ({ documentBody, headers, footers, footnotes, endnotes }: NormalizeRenderedPageBreakHintsInput) => void;
 //#endregion
-export { normalizeRenderedPageBreakHints };
+export {};

package/dist/docx/replyToComment.d.ts

@@ -1,6 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 //#region src/docx/replyToComment.d.ts
-type CreateCommentReplyInput = {
+export type CreateCommentReplyInput = {
   author: string;
   text: string;
   initials?: string;
@@ -17,13 +17,12 @@ type CreateCommentReplyInput = {
  * cannot anchor a thread. A reply to a reply re-parents onto the same thread as
  * the target (Word threads are flat: every reply links to the root).
  */
-declare const createReply: (comments: readonly document_d_exports.Comment[], parentCommentId: number, input: CreateCommentReplyInput) => document_d_exports.Comment | null;
+export declare const createReply: (comments: readonly document_d_exports.Comment[], parentCommentId: number, input: CreateCommentReplyInput) => document_d_exports.Comment | null;
 /**
  * Append a reply to `parentCommentId` in `doc`'s comment list, mutating the
  * document model in place, and return the created reply. Returns `null` when the
  * parent comment does not exist or cannot anchor a thread (see
  * {@link createReply}).
  */
-declare const replyToComment: (doc: document_d_exports.Document, parentCommentId: number, input: CreateCommentReplyInput) => document_d_exports.Comment | null;
-//#endregion
-export { CreateCommentReplyInput, createReply, replyToComment };
+export declare const replyToComment: (doc: document_d_exports.Document, parentCommentId: number, input: CreateCommentReplyInput) => document_d_exports.Comment | null;
+//#endregion

package/dist/docx/replyToComment.js

@@ -1,6 +1,7 @@
 import { allocateCommentId, seedCommentIdAbove } from "../prosemirror/commentIdAllocator.js";
 import { generateHexId } from "../utils/hexId.js";
 import { commentTextParagraph } from "./commentTextParagraph.js";
+import { setDocumentBodyComments } from "@stll/docx-core/model";
 //#region src/docx/replyToComment.ts
 /**
 * Create a threaded reply to an existing comment.
@@ -63,7 +64,7 @@ const replyToComment = (doc, parentCommentId, input) => {
 	const comments = doc.package.document.comments ?? [];
 	const reply = createReply(comments, parentCommentId, input);
 	if (!reply) return null;
-	doc.package.document.comments = [...comments, reply];
+	setDocumentBodyComments(doc.package.document, [...comments, reply]);
 	return reply;
 };
 //#endregion

package/dist/docx/reviewHistoryNamespace.d.ts

@@ -1,4 +1,3 @@
 //#region src/docx/reviewHistoryNamespace.d.ts
-declare const FOLIO_REVIEW_HISTORY_NAMESPACE = "urn:stella:folio:review-history:1";
-//#endregion
-export { FOLIO_REVIEW_HISTORY_NAMESPACE };
+export declare const FOLIO_REVIEW_HISTORY_NAMESPACE = "urn:stella:folio:review-history:1";
+//#endregion

package/dist/docx/reviewResolutionProvenance.d.ts

@@ -1,25 +1,29 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
+import { TaggedErrorClass } from "better-result";
+import { CopyOriginAncestorList } from "@stll/docx-core/ops";
 //#region src/docx/reviewResolutionProvenance.d.ts
 type ResolutionJoins = NonNullable<document_d_exports.Insertion["resolutionJoins"]>;
 type BoundaryJoins = NonNullable<document_d_exports.RunPropertyChange["boundaryJoins"]>;
-declare const isResolutionJoins: (value: unknown) => value is ResolutionJoins;
-declare const isParagraphMarkResolutionJoin: (value: unknown) => value is NonNullable<document_d_exports.ParagraphMarkChange["resolutionJoin"]>;
-declare const isBoundaryJoins: (value: unknown) => value is BoundaryJoins;
-declare const ReviewResolutionProvenanceError_base: import("better-result").TaggedErrorClass<"ReviewResolutionProvenanceError">;
-declare class ReviewResolutionProvenanceError extends ReviewResolutionProvenanceError_base<{
+export declare const isResolutionJoins: (value: unknown) => value is ResolutionJoins;
+export declare const isParagraphMarkResolutionJoin: (value: unknown) => value is NonNullable<document_d_exports.ParagraphMarkChange["resolutionJoin"]>;
+export declare const isBoundaryJoins: (value: unknown) => value is BoundaryJoins;
+declare const ReviewResolutionProvenanceErrorBase: TaggedErrorClass<"ReviewResolutionProvenanceError">;
+export declare class ReviewResolutionProvenanceError extends ReviewResolutionProvenanceErrorBase<{
   message: string;
   attribute: string;
   reason: "invalid" | "unsupportedVersion" | "unrepresentable";
 }> {}
-declare const parseResolutionJoins: (node: XmlElement) => ResolutionJoins | undefined;
-declare const parseBoundaryJoins: (node: XmlElement) => BoundaryJoins | undefined;
-declare const serializeResolutionJoins: (value: document_d_exports.Insertion["resolutionJoins"]) => string;
-declare const serializeBoundaryJoins: (value: document_d_exports.RunPropertyChange["boundaryJoins"]) => string;
+export declare const parseResolutionJoins: (node: XmlElement) => ResolutionJoins | undefined;
+export declare const parseBoundaryJoins: (node: XmlElement) => BoundaryJoins | undefined;
+export declare const parseCopyOriginAncestors: (node: XmlElement) => CopyOriginAncestorList | undefined;
+export declare const serializeResolutionJoins: (value: document_d_exports.Insertion["resolutionJoins"]) => string;
+export declare const serializeBoundaryJoins: (value: document_d_exports.RunPropertyChange["boundaryJoins"]) => string;
+export declare const serializeCopyOriginAncestors: (value: CopyOriginAncestorList | undefined) => string | undefined;
 /** Null carries an owned undefined depth; a missing attribute carries no field. */
-declare const parseParagraphMarkResolutionJoin: (node: XmlElement) => Pick<document_d_exports.ParagraphMarkChange, "resolutionJoin">;
-declare const serializeParagraphMarkResolutionJoin: (mark: document_d_exports.ParagraphMarkChange) => string;
+export declare const parseParagraphMarkResolutionJoin: (node: XmlElement) => Pick<document_d_exports.ParagraphMarkChange, "resolutionJoin">;
+export declare const serializeParagraphMarkResolutionJoin: (mark: document_d_exports.ParagraphMarkChange) => string;
 /** Captured paragraph properties compose the same envelope into a parsed XML element. */
-declare const paragraphMarkResolutionJoinAttributes: (mark: document_d_exports.ParagraphMarkChange) => Record<string, string>;
+export declare const paragraphMarkResolutionJoinAttributes: (mark: document_d_exports.ParagraphMarkChange) => Record<string, string>;
 //#endregion
-export { ReviewResolutionProvenanceError, isBoundaryJoins, isParagraphMarkResolutionJoin, isResolutionJoins, paragraphMarkResolutionJoinAttributes, parseBoundaryJoins, parseParagraphMarkResolutionJoin, parseResolutionJoins, serializeBoundaryJoins, serializeParagraphMarkResolutionJoin, serializeResolutionJoins };
+export {};

package/dist/docx/reviewResolutionProvenance.js

@@ -1,12 +1,13 @@
+import "../reviewHistoryLimits.js";
 import { FOLIO_REVIEW_HISTORY_NAMESPACE } from "./reviewHistoryNamespace.js";
 import { getAttributeByNamespaceUri } from "./xmlParser.js";
 import { Result, TaggedError } from "better-result";
 import { escapeXmlAttribute } from "@stll/docx-core";
 import { MAX_REVISION_ID } from "@stll/docx-core/model";
+import { isCopyOriginAncestors } from "@stll/docx-core/ops";
 //#region src/docx/reviewResolutionProvenance.ts
 const NAMESPACES = /* @__PURE__ */ new Set([FOLIO_REVIEW_HISTORY_NAMESPACE]);
 const VERSION = 1;
-const MAX_ATTRIBUTE_LENGTH = 32768;
 const SLOT_FIELDS = {
 	space: true,
 	id: true
@@ -64,7 +65,8 @@ const isResolutionJoins = (value) => record(value) && Object.keys(value).every((
 const isParagraphMarkResolutionJoin = (value) => natural(value) && value <= MAX_REVISION_ID;
 const isEncodedParagraphMarkResolutionJoin = (value) => value === null || isParagraphMarkResolutionJoin(value);
 const isBoundaryJoins = (value) => Array.isArray(value) && value.length <= 2 && new Set(value).size === value.length && value.every((side) => side === "before" || side === "after");
-var ReviewResolutionProvenanceError = class extends TaggedError("ReviewResolutionProvenanceError") {};
+const ReviewResolutionProvenanceErrorBase = TaggedError("ReviewResolutionProvenanceError");
+var ReviewResolutionProvenanceError = class extends ReviewResolutionProvenanceErrorBase {};
 const parseAttribute = ({ node, attribute, valid }) => {
 	const encoded = getAttributeByNamespaceUri(node, NAMESPACES, attribute);
 	if (encoded === null) return void 0;
@@ -73,7 +75,7 @@ const parseAttribute = ({ node, attribute, valid }) => {
 		message: `Invalid or unsupported ${attribute} review provenance.`,
 		reason
 	});
-	if (encoded.length > MAX_ATTRIBUTE_LENGTH) throw failed();
+	if (encoded.length > 32768) throw failed();
 	const parsed = Result.try({
 		try: () => JSON.parse(encoded),
 		catch: () => failed()
@@ -97,7 +99,7 @@ const encodeAttribute = ({ attribute, value, valid }) => {
 		version: VERSION,
 		value
 	});
-	if (encoded.length > MAX_ATTRIBUTE_LENGTH) throw new ReviewResolutionProvenanceError({
+	if (encoded.length > 32768) throw new ReviewResolutionProvenanceError({
 		attribute,
 		reason: "invalid",
 		message: `Oversized ${attribute} review provenance.`
@@ -118,6 +120,11 @@ const parseBoundaryJoins = (node) => parseAttribute({
 	attribute: "boundaryJoins",
 	valid: isBoundaryJoins
 });
+const parseCopyOriginAncestors = (node) => parseAttribute({
+	node,
+	attribute: "copyOriginAncestors",
+	valid: isCopyOriginAncestors
+});
 const serializeResolutionJoins = (value) => serializeAttribute({
 	attribute: "resolutionJoins",
 	value,
@@ -128,6 +135,11 @@ const serializeBoundaryJoins = (value) => serializeAttribute({
 	value,
 	valid: isBoundaryJoins
 });
+const serializeCopyOriginAncestors = (value) => encodeAttribute({
+	attribute: "copyOriginAncestors",
+	value,
+	valid: isCopyOriginAncestors
+});
 /** Null carries an owned undefined depth; a missing attribute carries no field. */
 const parseParagraphMarkResolutionJoin = (node) => {
 	const value = parseAttribute({
@@ -150,4 +162,4 @@ const paragraphMarkResolutionJoinAttributes = (mark) => {
 	return encoded === void 0 ? {} : { [`folio:${options.attribute}`]: encoded };
 };
 //#endregion
-export { ReviewResolutionProvenanceError, isBoundaryJoins, isParagraphMarkResolutionJoin, isResolutionJoins, paragraphMarkResolutionJoinAttributes, parseBoundaryJoins, parseParagraphMarkResolutionJoin, parseResolutionJoins, serializeBoundaryJoins, serializeParagraphMarkResolutionJoin, serializeResolutionJoins };
+export { ReviewResolutionProvenanceError, isBoundaryJoins, isParagraphMarkResolutionJoin, isResolutionJoins, paragraphMarkResolutionJoinAttributes, parseBoundaryJoins, parseCopyOriginAncestors, parseParagraphMarkResolutionJoin, parseResolutionJoins, serializeBoundaryJoins, serializeCopyOriginAncestors, serializeParagraphMarkResolutionJoin, serializeResolutionJoins };

package/dist/docx/revisionIdNormalization.d.ts

@@ -1,5 +1,6 @@
+import { TaggedErrorClass } from "better-result";
 //#region src/docx/revisionIdNormalization.d.ts
-declare const RevisionIdCollisionError_base: import("better-result").TaggedErrorClass<"RevisionIdCollisionError">;
+declare const RevisionIdCollisionErrorBase: TaggedErrorClass<"RevisionIdCollisionError">;
 /**
  * Two revision elements in one package claimed the same `w:id`.
  *
@@ -8,12 +9,12 @@ declare const RevisionIdCollisionError_base: import("better-result").TaggedError
  * normalization below hands every id it emits to one choke point, which throws
  * this rather than letting the duplicate reach the ZIP.
  */
-declare class RevisionIdCollisionError extends RevisionIdCollisionError_base<{
+export declare class RevisionIdCollisionError extends RevisionIdCollisionErrorBase<{
   message: string;
   revisionId: number;
   part: string;
 }> {}
-declare const REVISION_ELEMENT_NAMES: Set<string>;
+export declare const REVISION_ELEMENT_NAMES: Set<string>;
 /**
  * Keep physical tracked-change element ids unique across a package.
  *
@@ -22,6 +23,6 @@ declare const REVISION_ELEMENT_NAMES: Set<string>;
  * multiple physical OOXML wrappers; reopening therefore exposes the physical
  * wrapper IDs that the file format requires.
  */
-declare const normalizeRevisionIdsInXmlParts: (parts: ReadonlyMap<string, string>) => Map<string, string>;
+export declare const normalizeRevisionIdsInXmlParts: (parts: ReadonlyMap<string, string>) => Map<string, string>;
 //#endregion
-export { REVISION_ELEMENT_NAMES, RevisionIdCollisionError, normalizeRevisionIdsInXmlParts };
+export {};

package/dist/docx/revisionIdNormalization.js

@@ -3,6 +3,7 @@ import { WORDPROCESSINGML_NAMESPACE_URIS, findAttributeByNamespaceUri, getLocalN
 import { XmlResourceLimitError, assertXmlResourceLimits } from "./xmlResourceLimits.js";
 import { TaggedError } from "better-result";
 //#region src/docx/revisionIdNormalization.ts
+const RevisionIdCollisionErrorBase = TaggedError("RevisionIdCollisionError");
 /**
 * Two revision elements in one package claimed the same `w:id`.
 *
@@ -11,7 +12,7 @@ import { TaggedError } from "better-result";
 * normalization below hands every id it emits to one choke point, which throws
 * this rather than letting the duplicate reach the ZIP.
 */
-var RevisionIdCollisionError = class extends TaggedError("RevisionIdCollisionError") {};
+var RevisionIdCollisionError = class extends RevisionIdCollisionErrorBase {};
 const REVISION_ELEMENT_NAMES = /* @__PURE__ */ new Set([
 	"cellDel",
 	"cellIns",