@stll/folio-core 0.62.0 → 0.63.0

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
@@ -73,7 +74,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 +98,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 +119,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 +134,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 +161,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

@@ -8,12 +8,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 RevisionIdCollisionError_base<{
   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 +22,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/rezip.d.ts

@@ -1,13 +1,13 @@
 import { document_d_exports } from "../types/document.js";
 import { CANONICAL_GAP } from "../types/canonicalCapabilities.js";
-import { SaveDiagnosticOptions } from "./saveDiagnostics.js";
 import { BlockContent, Hyperlink } from "../types/content.js";
+import { SaveDiagnosticOptions } from "./saveDiagnostics.js";
 import { DocumentBodyAuthorityOptions } from "./serializer/documentSerializer.js";
 import { RawDocxContent } from "./unzip.js";
 import JSZip from "jszip";
 //#region src/docx/rezip.d.ts
 declare const DocxPackageFidelityError_base: import("better-result").TaggedErrorClass<"DocxPackageFidelityError">;
-declare class DocxPackageFidelityError extends DocxPackageFidelityError_base<{
+export declare class DocxPackageFidelityError extends DocxPackageFidelityError_base<{
   message: string;
 }> {
   constructor(message: string);
@@ -22,7 +22,7 @@ declare class DocxPackageFidelityError extends DocxPackageFidelityError_base<{
  * The paragraph is named because the count alone does not say which of them the
  * save invented.
  */
-declare class DocxDuplicateSectionCarrierError extends DocxPackageFidelityError {
+export declare class DocxDuplicateSectionCarrierError extends DocxPackageFidelityError {
   /** The `w:paraId` of the duplicate carrier, when the package gave it one. */
   readonly paraId: string | null;
   /** Its position among the paragraph-level carriers, in document order. */
@@ -38,7 +38,7 @@ declare class DocxDuplicateSectionCarrierError extends DocxPackageFidelityError
 /**
  * Find the highest rId number in a relationships XML string.
  */
-declare function findMaxRId(relsXml: string): number;
+export declare function findMaxRId(relsXml: string): number;
 /**
  * Every serialized section has exactly one model record, and vice versa.
  *
@@ -51,12 +51,12 @@ declare function findMaxRId(relsXml: string): number;
  * to `""` for a record holding settings it cannot write, so carrier uniqueness
  * alone does not prove the package states the sections the model holds.
  */
-declare const assertSectionCarriersMatchModel: ({ doc, serializedSectionCount }: {
+export declare const assertSectionCarriersMatchModel: ({ doc, serializedSectionCount }: {
   doc: document_d_exports.Document;
   serializedSectionCount: number;
 }) => void;
 declare const CanonicalImageRelationshipRefusalError_base: import("better-result").TaggedErrorClass<"CanonicalImageRelationshipRefusalError">;
-declare class CanonicalImageRelationshipRefusalError extends CanonicalImageRelationshipRefusalError_base<{
+export declare class CanonicalImageRelationshipRefusalError extends CanonicalImageRelationshipRefusalError_base<{
   message: string;
   gap: typeof CANONICAL_GAP.save;
   part: string;
@@ -69,17 +69,17 @@ type PublishCanonicalImageResourcesOptions = {
   compressionLevel: number;
 };
 /** Publish allocated pictures into each owning story without rebinding canonical ids. */
-declare const publishCanonicalImageResources: ({ document, zip, compressionLevel }: PublishCanonicalImageResourcesOptions) => Promise<void>;
+export declare const publishCanonicalImageResources: ({ document, zip, compressionLevel }: PublishCanonicalImageResourcesOptions) => Promise<void>;
 /** Newly authored text links; the census shares the complete owning-part traversal. */
-declare function collectHyperlinksWithoutRId(blocks: BlockContent[]): Hyperlink[];
+export declare function collectHyperlinksWithoutRId(blocks: BlockContent[]): Hyperlink[];
 /** The selective save boundary must use the same resource census as full repack. */
-declare const hasUnmaterializedInlineResources: (blocks: BlockContent[]) => boolean;
+export declare const hasUnmaterializedInlineResources: (blocks: BlockContent[]) => boolean;
 /** Compare against the already loaded source ZIP, without mutating model or package. */
-declare const hasUnmaterializedHyperlinkBindings: (document: document_d_exports.Document, zip: JSZip) => Promise<boolean>;
+export declare const hasUnmaterializedHyperlinkBindings: (document: document_d_exports.Document, zip: JSZip) => Promise<boolean>;
 /**
  * Options for repacking DOCX
  */
-type RepackOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
+export type RepackOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   /** Compression level (0-9, default: 6) */
   compressionLevel?: number;
   /** Whether to update modification date in docProps/core.xml */
@@ -89,7 +89,7 @@ type RepackOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   /** Changed note paragraphs that must be serialized even without source paraIds. */
   changedNoteParaIds?: ReadonlySet<string>;
 };
-declare function repackDocx(doc: document_d_exports.Document, options?: RepackOptions): Promise<ArrayBuffer>;
+export declare function repackDocx(doc: document_d_exports.Document, options?: RepackOptions): Promise<ArrayBuffer>;
 /**
  * Repack a Document using raw content for more control
  *
@@ -98,15 +98,15 @@ declare function repackDocx(doc: document_d_exports.Document, options?: RepackOp
  * @param options - Optional repack options
  * @returns Promise resolving to DOCX as ArrayBuffer
  */
-declare function repackDocxFromRaw(doc: document_d_exports.Document, rawContent: RawDocxContent, options?: RepackOptions): Promise<ArrayBuffer>;
-declare const COMMENTS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml";
-declare const COMMENTS_EXTENDED_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml";
-declare const COMMENTS_EXTENDED_PART = "word/commentsExtended.xml";
-declare const COMMENTS_EXTENDED_PART_LOWER = "word/commentsextended.xml";
-declare function addCommentsExtendedOverride(contentTypesXml: string): string;
-declare function removeCommentsExtendedOverride(contentTypesXml: string): string;
-declare function addCommentsExtendedRelationship(relsXml: string): string;
-declare function removeCommentsExtendedRelationship(relsXml: string): string;
+export declare function repackDocxFromRaw(doc: document_d_exports.Document, rawContent: RawDocxContent, options?: RepackOptions): Promise<ArrayBuffer>;
+export declare const COMMENTS_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml";
+export declare const COMMENTS_EXTENDED_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.wordprocessingml.commentsExtended+xml";
+export declare const COMMENTS_EXTENDED_PART = "word/commentsExtended.xml";
+export declare const COMMENTS_EXTENDED_PART_LOWER = "word/commentsextended.xml";
+export declare function addCommentsExtendedOverride(contentTypesXml: string): string;
+export declare function removeCommentsExtendedOverride(contentTypesXml: string): string;
+export declare function addCommentsExtendedRelationship(relsXml: string): string;
+export declare function removeCommentsExtendedRelationship(relsXml: string): string;
 /** Result of filtering the settings part; `undefined` means "leave as it is". */
 type SettingsWithoutAttachedTemplate = {
   settingsXml: string | undefined;
@@ -126,7 +126,7 @@ type SettingsWithoutAttachedTemplate = {
  * The removal itself is a byte splice, so everything else in both parts
  * round-trips exactly as authored.
  */
-declare function withoutAttachedTemplate(settingsXml: string, relsXml: string | undefined): SettingsWithoutAttachedTemplate;
+export declare function withoutAttachedTemplate(settingsXml: string, relsXml: string | undefined): SettingsWithoutAttachedTemplate;
 /**
  * Update only document.xml in a DOCX buffer (minimal changes)
  *
@@ -135,7 +135,7 @@ declare function withoutAttachedTemplate(settingsXml: string, relsXml: string |
  * @param options - Optional repack options
  * @returns Promise resolving to DOCX as ArrayBuffer
  */
-declare function updateDocumentXml(originalBuffer: ArrayBuffer, newDocumentXml: string, options?: RepackOptions): Promise<ArrayBuffer>;
+export declare function updateDocumentXml(originalBuffer: ArrayBuffer, newDocumentXml: string, options?: RepackOptions): Promise<ArrayBuffer>;
 /**
  * Update a specific XML file in a DOCX buffer
  *
@@ -145,7 +145,7 @@ declare function updateDocumentXml(originalBuffer: ArrayBuffer, newDocumentXml:
  * @param options - Optional repack options
  * @returns Promise resolving to DOCX as ArrayBuffer
  */
-declare function updateXmlFile(originalBuffer: ArrayBuffer, path: string, content: string, options?: RepackOptions): Promise<ArrayBuffer>;
+export declare function updateXmlFile(originalBuffer: ArrayBuffer, path: string, content: string, options?: RepackOptions): Promise<ArrayBuffer>;
 /**
  * Update multiple files in a DOCX buffer
  *
@@ -154,7 +154,7 @@ declare function updateXmlFile(originalBuffer: ArrayBuffer, path: string, conten
  * @param options - Optional repack options
  * @returns Promise resolving to DOCX as ArrayBuffer
  */
-declare function updateMultipleFiles(originalBuffer: ArrayBuffer, updates: Map<string, string | ArrayBuffer>, options?: RepackOptions): Promise<ArrayBuffer>;
+export declare function updateMultipleFiles(originalBuffer: ArrayBuffer, updates: Map<string, string | ArrayBuffer>, options?: RepackOptions): Promise<ArrayBuffer>;
 /**
  * Apply file updates to an already-loaded JSZip instance and generate the output.
  * Use this when the zip is already loaded to avoid a redundant decompression pass.
@@ -165,7 +165,7 @@ declare function updateMultipleFiles(originalBuffer: ArrayBuffer, updates: Map<s
  * revision ids are free and because an out-of-range paragraph id, or a
  * malformed application version, can sit in a part it never touched.
  */
-declare function applyUpdatesToZip(zip: JSZip, updates: Map<string, string | ArrayBuffer>, options?: RepackOptions): Promise<ArrayBuffer>;
+export declare function applyUpdatesToZip(zip: JSZip, updates: Map<string, string | ArrayBuffer>, options?: RepackOptions): Promise<ArrayBuffer>;
 /**
  * Add a new relationship to document.xml.rels
  *
@@ -173,7 +173,7 @@ declare function applyUpdatesToZip(zip: JSZip, updates: Map<string, string | Arr
  * @param relationship - New relationship to add
  * @returns Promise resolving to { buffer: ArrayBuffer, rId: string }
  */
-declare function addRelationship(originalBuffer: ArrayBuffer, relationship: {
+export declare function addRelationship(originalBuffer: ArrayBuffer, relationship: {
   type: string;
   target: string;
   targetMode?: "External" | "Internal";
@@ -190,7 +190,7 @@ declare function addRelationship(originalBuffer: ArrayBuffer, relationship: {
  * @param mimeType - MIME type (e.g., "image/png")
  * @returns Promise resolving to { buffer: ArrayBuffer, rId: string, path: string }
  */
-declare function addMedia(originalBuffer: ArrayBuffer, filename: string, data: ArrayBuffer, mimeType: string): Promise<{
+export declare function addMedia(originalBuffer: ArrayBuffer, filename: string, data: ArrayBuffer, mimeType: string): Promise<{
   buffer: ArrayBuffer;
   rId: string;
   path: string;
@@ -202,7 +202,7 @@ declare function addMedia(originalBuffer: ArrayBuffer, filename: string, data: A
  * relationship, and `[Content_Types]` entry. The selective fast-path can't
  * register those, so it must bail to a full repack when this returns true.
  */
-declare function hasUnmaterializedHeaderFooter(doc: document_d_exports.Document): boolean;
+export declare function hasUnmaterializedHeaderFooter(doc: document_d_exports.Document): boolean;
 /**
  * A picture watermark is "model-driven" when its raw VML was cleared (so the
  * serializer synthesizes `<v:imagedata r:id>` from `imageRId`). Its image
@@ -211,7 +211,7 @@ declare function hasUnmaterializedHeaderFooter(doc: document_d_exports.Document)
  * watermark is present, regardless of header count (a single header's rId could
  * have been set without yet resolving in that header's rels).
  */
-declare function hasModelDrivenPictureWatermark(doc: document_d_exports.Document): boolean;
+export declare function hasModelDrivenPictureWatermark(doc: document_d_exports.Document): boolean;
 /**
  * Re-serialize every header/footer the model still owns, keyed by part path.
  *
@@ -221,7 +221,7 @@ declare function hasModelDrivenPictureWatermark(doc: document_d_exports.Document
 type CollectHeaderFooterUpdatesOptions = SaveDiagnosticOptions & {
   sourceZip: JSZip;
 };
-declare function collectHeaderFooterUpdates(doc: document_d_exports.Document, { sourceZip, onDiagnostic }: CollectHeaderFooterUpdatesOptions): Promise<Map<string, string>>;
+export declare function collectHeaderFooterUpdates(doc: document_d_exports.Document, { sourceZip, onDiagnostic }: CollectHeaderFooterUpdatesOptions): Promise<Map<string, string>>;
 type AddedStylesPlan = {
   type: "unchanged";
 } | {
@@ -233,11 +233,11 @@ type AddedStylesPlan = {
   xml: string;
 };
 /** One append-only style owner for full repack and selective overlays. */
-declare function planAddedStyles(doc: document_d_exports.Document, originalZip: JSZip): Promise<AddedStylesPlan>;
+export declare function planAddedStyles(doc: document_d_exports.Document, originalZip: JSZip): Promise<AddedStylesPlan>;
 /** `word/Footnotes.xml` -> `word/_rels/Footnotes.xml.rels` (casing preserved). */
-declare function notePartRelsPath(partPath: string): string;
+export declare function notePartRelsPath(partPath: string): string;
 /** Update existing core-property values without synthesizing absent metadata. */
-declare function updateCoreProperties(corePropsXml: string, { updateModifiedDate, modifiedBy }: {
+export declare function updateCoreProperties(corePropsXml: string, { updateModifiedDate, modifiedBy }: {
   updateModifiedDate?: boolean;
   modifiedBy?: string;
 }): string;
@@ -247,7 +247,7 @@ declare function updateCoreProperties(corePropsXml: string, { updateModifiedDate
  * @param buffer - Buffer to validate
  * @returns Promise resolving to validation result
  */
-declare const validateDocx: (buffer: ArrayBuffer) => Promise<{
+export declare const validateDocx: (buffer: ArrayBuffer) => Promise<{
   valid: boolean;
   errors: string[];
   warnings: string[];
@@ -258,7 +258,7 @@ declare const validateDocx: (buffer: ArrayBuffer) => Promise<{
  * @param buffer - Buffer to check
  * @returns true if buffer starts with ZIP signature
  */
-declare function isDocxBuffer(buffer: ArrayBuffer): boolean;
+export declare function isDocxBuffer(buffer: ArrayBuffer): boolean;
 /**
  * The document properties a package built from scratch states about itself.
  *
@@ -267,7 +267,7 @@ declare function isDocxBuffer(buffer: ArrayBuffer): boolean;
  * ignored for a document that carries a source package, which keeps the
  * properties that package already states.
  */
-type DocumentPropertiesOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
+export type DocumentPropertiesOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   /** `dc:creator` in `docProps/core.xml`. Omitted when absent. */
   creator?: string;
   /** `Application` in `docProps/app.xml`. Omitted, with `AppVersion`, when absent. */
@@ -279,7 +279,7 @@ type DocumentPropertiesOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOp
  * @param properties - Document properties the package states about itself
  * @returns Promise resolving to minimal DOCX as ArrayBuffer
  */
-declare function createEmptyDocx(properties?: DocumentPropertiesOptions): Promise<ArrayBuffer>;
+export declare function createEmptyDocx(properties?: DocumentPropertiesOptions): Promise<ArrayBuffer>;
 /**
  * Create a new DOCX from a Document (without requiring original buffer)
  *
@@ -288,6 +288,6 @@ declare function createEmptyDocx(properties?: DocumentPropertiesOptions): Promis
  *   about itself; ignored when `doc` carries a source package
  * @returns Promise resolving to DOCX as ArrayBuffer
  */
-declare function createDocx(doc: document_d_exports.Document, properties?: DocumentPropertiesOptions): Promise<ArrayBuffer>;
+export declare function createDocx(doc: document_d_exports.Document, properties?: DocumentPropertiesOptions): Promise<ArrayBuffer>;
 //#endregion
-export { COMMENTS_CONTENT_TYPE, COMMENTS_EXTENDED_CONTENT_TYPE, COMMENTS_EXTENDED_PART, COMMENTS_EXTENDED_PART_LOWER, CanonicalImageRelationshipRefusalError, DocumentPropertiesOptions, DocxDuplicateSectionCarrierError, DocxPackageFidelityError, RepackOptions, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, assertSectionCarriersMatchModel, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, hasUnmaterializedHyperlinkBindings, hasUnmaterializedInlineResources, isDocxBuffer, notePartRelsPath, planAddedStyles, publishCanonicalImageResources, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };
+export {};