@stll/folio-core 0.55.0 → 0.57.0

package/dist/docx/rezip.d.ts

@@ -1,6 +1,8 @@
 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 { DocumentBodyAuthorityOptions } from "./serializer/documentSerializer.js";
 import { RawDocxContent } from "./unzip.js";
 import JSZip from "jszip";
 //#region src/docx/rezip.d.ts
@@ -38,16 +40,46 @@ declare class DocxDuplicateSectionCarrierError extends DocxPackageFidelityError
  */
 declare function findMaxRId(relsXml: string): number;
 /**
- * Collect all hyperlinks that have an href but no rId from block content.
- * These are newly created hyperlinks that need relationship entries.
+ * Every serialized section has exactly one model record, and vice versa.
+ *
+ * A split paragraph's duplicated `w:sectPr` is a section nobody added,
+ * repeating the real one's `w:rsidSect` and claiming its revision history too.
+ * Two carriers over one record are therefore invalid regardless of whether a
+ * separate deletion makes the total section count rise, fall, or stay equal.
+ *
+ * The count is a separate invariant: `serializeSectionProperties` fails closed
+ * 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 }: {
+  doc: document_d_exports.Document;
+  serializedSectionCount: number;
+}) => void;
+declare const CanonicalImageRelationshipRefusalError_base: import("better-result").TaggedErrorClass<"CanonicalImageRelationshipRefusalError">;
+declare class CanonicalImageRelationshipRefusalError extends CanonicalImageRelationshipRefusalError_base<{
+  message: string;
+  gap: typeof CANONICAL_GAP.save;
+  part: string;
+  relationshipId: string;
+  reason: "conflict" | "unresolved" | "missingMedia" | "unsafeTarget";
+}> {}
+type PublishCanonicalImageResourcesOptions = {
+  document: document_d_exports.Document;
+  zip: JSZip;
+  compressionLevel: number;
+};
+/** Publish allocated pictures into each owning story without rebinding canonical ids. */
+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[];
 /** The selective save boundary must use the same resource census as full repack. */
 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>;
 /**
  * Options for repacking DOCX
  */
-type RepackOptions = SaveDiagnosticOptions & {
+type RepackOptions = SaveDiagnosticOptions & DocumentBodyAuthorityOptions & {
   /** Compression level (0-9, default: 6) */
   compressionLevel?: number;
   /** Whether to update modification date in docProps/core.xml */
@@ -190,6 +222,18 @@ type CollectHeaderFooterUpdatesOptions = SaveDiagnosticOptions & {
   sourceZip: JSZip;
 };
 declare function collectHeaderFooterUpdates(doc: document_d_exports.Document, { sourceZip, onDiagnostic }: CollectHeaderFooterUpdatesOptions): Promise<Map<string, string>>;
+type AddedStylesPlan = {
+  type: "unchanged";
+} | {
+  type: "materialize";
+  styles: document_d_exports.StyleDefinitions;
+} | {
+  type: "patch";
+  path: string;
+  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>;
 /** `word/Footnotes.xml` -> `word/_rels/Footnotes.xml.rels` (casing preserved). */
 declare function notePartRelsPath(partPath: string): string;
 /** Update existing core-property values without synthesizing absent metadata. */
@@ -223,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 & {
+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. */
@@ -246,4 +290,4 @@ declare function createEmptyDocx(properties?: DocumentPropertiesOptions): Promis
  */
 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, DocumentPropertiesOptions, DocxDuplicateSectionCarrierError, DocxPackageFidelityError, RepackOptions, addCommentsExtendedOverride, addCommentsExtendedRelationship, addMedia, addRelationship, applyUpdatesToZip, collectHeaderFooterUpdates, collectHyperlinksWithoutRId, createDocx, createEmptyDocx, findMaxRId, hasModelDrivenPictureWatermark, hasUnmaterializedHeaderFooter, hasUnmaterializedInlineResources, isDocxBuffer, notePartRelsPath, removeCommentsExtendedOverride, removeCommentsExtendedRelationship, repackDocx, repackDocxFromRaw, updateCoreProperties, updateDocumentXml, updateMultipleFiles, updateXmlFile, validateDocx, withoutAttachedTemplate };
+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 };