@stll/folio-core 0.64.0 → 0.65.0

package/dist/docx/drawingIdNormalization.js

@@ -5,7 +5,7 @@ import { captureVerbatimXml } from "./verbatimCapture.js";
 import { NAMESPACES, OOXML_NAMESPACE_SCOPE, getLocalName, getNamespaceUri, parseXml } from "./xmlParser.js";
 import { panic } from "better-result";
 import { assertValidOoxmlNumericId, isValidOoxmlNumericId } from "@stll/docx-core";
-//#region src/docx/drawingIdNormalization.ts
+// src/docx/drawingIdNormalization.ts
 const GENERATED_DRAWING_ID_START = 1e5;
 const isDetachedRawDrawing = (drawing) => drawing?.rawXml !== void 0 && isNewDataUrlDrawing(drawing);
 const reassignRawDrawingId = ({ xml, id }) => {
@@ -92,5 +92,4 @@ const normalizeDrawingIds = (surfaces) => {
 		nextId += 1;
 	}
 };
-//#endregion
 export { drawingXmlWithoutIdentity, normalizeDrawingIds };

package/dist/docx/drawingRelationships.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/drawingRelationships.d.ts
 type RebindDrawingImageRelationshipOptions = {
   xml: string;
   previousId: string;
@@ -6,5 +5,4 @@ type RebindDrawingImageRelationshipOptions = {
 };
 /** Only a single embedded image can travel without importing other package resources. */
 export declare const rebindDrawingImageRelationship: ({ xml, previousId, nextId }: RebindDrawingImageRelationshipOptions) => string | null;
-//#endregion
 export {};

package/dist/docx/drawingRelationships.js

@@ -1,6 +1,6 @@
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, OOXML_NAMESPACE_SCOPE, findAttributeByNamespaceUri, getLocalName, getNamespaceUri, parseXml } from "./xmlParser.js";
-//#region src/docx/drawingRelationships.ts
+// src/docx/drawingRelationships.ts
 /** Only a single embedded image can travel without importing other package resources. */
 const rebindDrawingImageRelationship = ({ xml, previousId, nextId }) => {
 	const root = parseXml(xml, OOXML_NAMESPACE_SCOPE);
@@ -24,5 +24,4 @@ const rebindDrawingImageRelationship = ({ xml, previousId, nextId }) => {
 	if (unsupported || embeddedCount !== 1) return null;
 	return (root.elements ?? []).map(captureVerbatimXml).join("");
 };
-//#endregion
 export { rebindDrawingImageRelationship };

package/dist/docx/drawingUtils.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { ParseContext } from "./parseContext.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/drawingUtils.d.ts
 /**
  * Parse a color value from a DrawingML element.
  * Handles: a:srgbClr, a:schemeClr, a:sysClr, a:prstClr
@@ -84,5 +83,4 @@ export declare function parseAnchorWrap(anchor: XmlElement): document_d_exports.
  * Resolve a ColorValue to a CSS hex string using default theme colors.
  * For use when no Theme object is available (e.g., shape/text box parsing).
  */
-export declare function resolveColorValueToHex(color: document_d_exports.ColorValue | undefined): string | undefined;
-//#endregion
+export declare function resolveColorValueToHex(color: document_d_exports.ColorValue | undefined): string | undefined;

package/dist/docx/drawingUtils.js

@@ -3,7 +3,7 @@ import { ImageHorizontalAlignmentSchema, ImageHorizontalRelativeToSchema, ImageV
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { findChildByLocalName, findChildByNamespaceUri, findChildrenByLocalName, getAttribute, getChildElements, getLocalName, getNamespaceUri, getTextContent, parseNumericAttribute, parseOnOffValue } from "./xmlParser.js";
 import { PARSE_WARNING_CODES, THEME_COLOR_BY_SCHEME_COLOR_VALUE, isPresetLineDashVal, isSchemeColorValue, presetLineDashFrom, themeColorSlot } from "@stll/docx-core/model";
-//#region src/docx/drawingUtils.ts
+// src/docx/drawingUtils.ts
 /**
 * Shared DrawingML Parsing Utilities
 *
@@ -509,5 +509,4 @@ function resolveColorValueToHex(color) {
 		return `#${slot === void 0 ? "000000" : DEFAULT_THEME_COLOR_HEX[slot]}`;
 	}
 }
-//#endregion
 export { findWrapElement, parseAnchorBehindDoc, parseAnchorPosition, parseAnchorWrap, parseColorElement, parseDrawingEffectExtent, parseEffectExtent, parseFill, parseInlineWrap, parseOutline, parsePositionH, parsePositionV, parseWrapElement, resolveColorValueToHex };

package/dist/docx/encryption/agileDecryption.d.ts

@@ -1,4 +1,2 @@
 import { AgileKeyMaterial } from "./encryptionInfo.js";
-//#region src/docx/encryption/agileDecryption.d.ts
-export declare const decryptAgileEncryptedPackage: (password: string, material: AgileKeyMaterial, encryptedPackage: Uint8Array) => Promise<Uint8Array>;
-//#endregion
+export declare const decryptAgileEncryptedPackage: (password: string, material: AgileKeyMaterial, encryptedPackage: Uint8Array) => Promise<Uint8Array>;

package/dist/docx/encryption/agileDecryption.js

@@ -1,7 +1,7 @@
 import { bytesEqual, joinBytes, padToBlock, passwordToUtf16Le, toArrayBuffer, writeUint32Le } from "./cryptoBytes.js";
 import { MAX_SPIN_COUNT } from "./encryptionInfo.js";
 import { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError } from "./errors.js";
-//#region src/docx/encryption/agileDecryption.ts
+// src/docx/encryption/agileDecryption.ts
 /**
 * Agile Encryption decryption (Office 2010+) using Web Crypto.
 *
@@ -215,5 +215,4 @@ const decryptAgileEncryptedPackage = async (password, material, encryptedPackage
 		});
 	}
 };
-//#endregion
 export { decryptAgileEncryptedPackage };

package/dist/docx/encryption/compoundFile.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/encryption/compoundFile.d.ts
 export type CompoundFileReader = {
   readStream: (absolutePath: string) => Uint8Array | null;
 };
@@ -7,5 +6,4 @@ export type EncryptedPackageStreams = {
   encryptionInfo: Uint8Array;
   encryptedPackage: Uint8Array;
 };
-export declare const readEncryptedPackageStreams: (data: ArrayBuffer | Uint8Array) => EncryptedPackageStreams;
-//#endregion
+export declare const readEncryptedPackageStreams: (data: ArrayBuffer | Uint8Array) => EncryptedPackageStreams;

package/dist/docx/encryption/compoundFile.js

@@ -1,6 +1,6 @@
 import { decodeText } from "../../utils/textEncoding.js";
 import { joinBytes } from "./cryptoBytes.js";
-//#region src/docx/encryption/compoundFile.ts
+// src/docx/encryption/compoundFile.ts
 /**
 * Read-only MS-CFB compound file access for encrypted OOXML packages.
 *
@@ -253,5 +253,4 @@ const readEncryptedPackageStreams = (data) => {
 		encryptedPackage
 	};
 };
-//#endregion
 export { openCompoundFile, readEncryptedPackageStreams };

package/dist/docx/encryption/containerFormat.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/encryption/containerFormat.d.ts
 /**
  * OOXML container format detection (ZIP vs encrypted OLE compound file).
  *
@@ -10,5 +9,4 @@ export declare const DOCX_CONTAINER_TYPES: {
   readonly UNKNOWN: "unknown";
 };
 export type DocxContainerType = (typeof DOCX_CONTAINER_TYPES)[keyof typeof DOCX_CONTAINER_TYPES];
-export declare const detectDocxContainerType: (data: ArrayBuffer | Uint8Array) => DocxContainerType;
-//#endregion
+export declare const detectDocxContainerType: (data: ArrayBuffer | Uint8Array) => DocxContainerType;

package/dist/docx/encryption/containerFormat.js

@@ -1,4 +1,4 @@
-//#region src/docx/encryption/containerFormat.ts
+// src/docx/encryption/containerFormat.ts
 /**
 * OOXML container format detection (ZIP vs encrypted OLE compound file).
 *
@@ -36,5 +36,4 @@ const detectDocxContainerType = (data) => {
 	if (startsWith(bytes, OLE_SIGNATURE)) return DOCX_CONTAINER_TYPES.CFB;
 	return DOCX_CONTAINER_TYPES.UNKNOWN;
 };
-//#endregion
 export { DOCX_CONTAINER_TYPES, detectDocxContainerType };

package/dist/docx/encryption/cryptoBytes.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/encryption/cryptoBytes.d.ts
 /** Byte helpers shared by MS-CFB and MS-OFFCRYPTO agile decryption. */
 export declare const joinBytes: (parts: readonly Uint8Array[]) => Uint8Array;
 export declare const writeUint32Le: (value: number) => Uint8Array;
@@ -6,5 +5,4 @@ export declare const passwordToUtf16Le: (text: string) => Uint8Array<ArrayBuffer
 export declare const bytesEqual: (left: Uint8Array, right: Uint8Array) => boolean;
 export declare const toArrayBuffer: (bytes: Uint8Array) => ArrayBuffer;
 export declare const decodeBase64: (text: string) => Uint8Array<ArrayBuffer>;
-export declare const padToBlock: (bytes: Uint8Array, blockSize: number, padByte?: number) => Uint8Array;
-//#endregion
+export declare const padToBlock: (bytes: Uint8Array, blockSize: number, padByte?: number) => Uint8Array;

package/dist/docx/encryption/cryptoBytes.js

@@ -1,5 +1,5 @@
 import { base64ToBytes, encodeUtf16LE } from "../../utils/textEncoding.js";
-//#region src/docx/encryption/cryptoBytes.ts
+// src/docx/encryption/cryptoBytes.ts
 /** Byte helpers shared by MS-CFB and MS-OFFCRYPTO agile decryption. */
 const joinBytes = (parts) => {
 	let total = 0;
@@ -39,5 +39,4 @@ const padToBlock = (bytes, blockSize, padByte = 54) => {
 	out.fill(padByte, bytes.length);
 	return out;
 };
-//#endregion
 export { bytesEqual, decodeBase64, joinBytes, padToBlock, passwordToUtf16Le, toArrayBuffer, writeUint32Le };

package/dist/docx/encryption/encryptionInfo.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/encryption/encryptionInfo.d.ts
 export type AgileKeyMaterial = {
   packageSalt: Uint8Array;
   packageKeyBits: number;
@@ -30,5 +29,4 @@ export type AgileEncryptionDescriptor = {
  * multiple of that default instead of trusting the file.
  */
 export declare const MAX_SPIN_COUNT = 200000;
-export declare const parseAgileEncryptionInfo: (stream: Uint8Array) => AgileEncryptionDescriptor;
-//#endregion
+export declare const parseAgileEncryptionInfo: (stream: Uint8Array) => AgileEncryptionDescriptor;

package/dist/docx/encryption/encryptionInfo.js

@@ -1,7 +1,7 @@
 import { decodeText } from "../../utils/textEncoding.js";
 import { decodeBase64 } from "./cryptoBytes.js";
 import { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError } from "./errors.js";
-//#region src/docx/encryption/encryptionInfo.ts
+// src/docx/encryption/encryptionInfo.ts
 /**
 * Parse the EncryptionInfo stream for Agile Encryption (Office 2010+).
 *
@@ -141,5 +141,4 @@ const parseAgileEncryptionInfo = (stream) => {
 		message: `Unrecognized EncryptionInfo header version=${version} kind=${kind}`
 	});
 };
-//#endregion
 export { MAX_SPIN_COUNT, parseAgileEncryptionInfo };

package/dist/docx/encryption/errors.d.ts

@@ -1,5 +1,4 @@
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/encryption/errors.d.ts
 /** Machine-readable codes for password-protected OOXML failures. */
 export declare const DOCX_ENCRYPTION_ERROR_CODES: {
   readonly PASSWORD_REQUIRED: "DOCX_PASSWORD_REQUIRED";
@@ -15,5 +14,4 @@ export declare class DocxEncryptionError extends DocxEncryptionErrorBase<{
   cause?: unknown;
 }> {}
 export declare const isDocxEncryptionError: (error: unknown) => error is DocxEncryptionError;
-//#endregion
 export {};

package/dist/docx/encryption/errors.js

@@ -1,5 +1,5 @@
 import { TaggedError } from "better-result";
-//#region src/docx/encryption/errors.ts
+// src/docx/encryption/errors.ts
 /** Machine-readable codes for password-protected OOXML failures. */
 const DOCX_ENCRYPTION_ERROR_CODES = {
 	PASSWORD_REQUIRED: "DOCX_PASSWORD_REQUIRED",
@@ -10,5 +10,4 @@ const DOCX_ENCRYPTION_ERROR_CODES = {
 const DocxEncryptionErrorBase = TaggedError("DocxEncryptionError");
 var DocxEncryptionError = class extends DocxEncryptionErrorBase {};
 const isDocxEncryptionError = (error) => error instanceof DocxEncryptionError;
-//#endregion
 export { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, isDocxEncryptionError };

package/dist/docx/encryption/openEncryptedDocx.d.ts

@@ -1,4 +1,3 @@
-//#region src/docx/encryption/openEncryptedDocx.d.ts
 /**
  * Decrypt password-protected OOXML before ZIP extraction.
  *
@@ -26,5 +25,4 @@ export type DecryptDocxResult = {
  */
 export declare const decryptDocxIfNeeded: (data: ArrayBuffer | Uint8Array, options?: DecryptDocxOptions) => Promise<DecryptDocxResult>;
 /** Open a `.docx` buffer for parsing: decrypt when encrypted, then return the ZIP bytes. */
-export declare const openDocxBuffer: (data: ArrayBuffer | Uint8Array, options?: DecryptDocxOptions) => Promise<ArrayBuffer>;
-//#endregion
+export declare const openDocxBuffer: (data: ArrayBuffer | Uint8Array, options?: DecryptDocxOptions) => Promise<ArrayBuffer>;

package/dist/docx/encryption/openEncryptedDocx.js

@@ -4,7 +4,7 @@ import { DOCX_CONTAINER_TYPES, detectDocxContainerType } from "./containerFormat
 import { toArrayBuffer } from "./cryptoBytes.js";
 import { parseAgileEncryptionInfo } from "./encryptionInfo.js";
 import { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError } from "./errors.js";
-//#region src/docx/encryption/openEncryptedDocx.ts
+// src/docx/encryption/openEncryptedDocx.ts
 /**
 * Decrypt password-protected OOXML before ZIP extraction.
 *
@@ -61,5 +61,4 @@ const decryptDocxIfNeeded = async (data, options = {}) => {
 };
 /** Open a `.docx` buffer for parsing: decrypt when encrypted, then return the ZIP bytes. */
 const openDocxBuffer = async (data, options = {}) => (await decryptDocxIfNeeded(data, options)).data;
-//#endregion
 export { decryptDocxIfNeeded, openDocxBuffer };

package/dist/docx/ensureParaIds.d.ts

@@ -1,5 +1,4 @@
 import { TaggedErrorClass } from "better-result";
-//#region src/docx/ensureParaIds.d.ts
 declare const EnsureParaIdsErrorBase: TaggedErrorClass<"EnsureParaIdsError">;
 export declare const ENSURE_PARA_IDS_REASONS: {
   readonly NORMALIZATION_FAILED: "normalization-failed";
@@ -41,5 +40,4 @@ export type EnsureParaIdsOptions = {
  * XML, and compression failures are surfaced as {@link EnsureParaIdsError}.
  */
 export declare const ensureParaIds: (docx: Uint8Array | ArrayBuffer, options?: EnsureParaIdsOptions) => Promise<EnsureParaIdsResult>;
-//#endregion
 export {};

package/dist/docx/ensureParaIds.js

@@ -1,5 +1,4 @@
 import { deterministicHexId } from "../utils/hexId.js";
-import { encodeUtf8 } from "../utils/textEncoding.js";
 import { resolvePackageRelationshipTarget } from "./packageParts.js";
 import { spliceXml } from "./selectiveXmlPatch.js";
 import { loadDocxArchive } from "./server/boundedArchive.js";
@@ -7,9 +6,8 @@ import { scanStreamingXmlElements } from "./streamingXmlParser.js";
 import { resolveNamespaceUri } from "./xmlNamespaceContext.js";
 import { OFFICE_RELATIONSHIP_NAMESPACE_URIS, WORDPROCESSINGML_NAMESPACE_URIS, getAttribute, getChildElements, getLocalName, getNamespaceUri, parseXmlDocument, resolveAttributeNamespaceUri } from "./xmlParser.js";
 import { TaggedError } from "better-result";
-import JSZip from "jszip";
-import { writeZipPart } from "@stll/docx-core/zip";
-//#region src/docx/ensureParaIds.ts
+import { ZipArchive } from "@stll/docx-core/zip";
+// src/docx/ensureParaIds.ts
 /**
 * Headless `w14:paraId` normalization for a `.docx` buffer.
 *
@@ -321,7 +319,7 @@ const mainDocumentPart = (rels, entries) => {
 /** OPC part names are case-insensitive; compare lowercased. */
 const isTargetPart = (path) => TARGET_PART_PATTERNS.some((pattern) => pattern.test(path.toLowerCase()));
 const toUint8Array = (docx) => docx instanceof Uint8Array ? docx : new Uint8Array(docx);
-const hasDigitalSignatureParts = (zip) => Object.values(zip.files).some(({ dir, name }) => !dir && name.toLowerCase().startsWith(DIGITAL_SIGNATURE_PART_PREFIX));
+const hasDigitalSignatureParts = (zip) => zip.entries().some(({ path }) => path.toLowerCase().startsWith(DIGITAL_SIGNATURE_PART_PREFIX));
 /**
 * Backfill `w14:paraId` on every paragraph of a `.docx` buffer. See the
 * module doc for the exact contract. Throws {@link EnsureParaIdsError} when
@@ -381,31 +379,18 @@ const ensureParaIdsInternal = async (docx, options) => {
 		alreadyComplete: true,
 		mintedParaIds: []
 	};
-	const zip = await JSZip.loadAsync(docx);
+	const zip = await ZipArchive.read(docx);
 	if (hasDigitalSignatureParts(zip) && options.allowSignedPackageMutation !== true) throw new EnsureParaIdsError({
 		reason: ENSURE_PARA_IDS_REASONS.SIGNED_PACKAGE,
 		message: "Refusing to normalize a digitally signed package because rewriting OOXML invalidates its signatures. Warn the user and pass allowSignedPackageMutation only if invalidation is acceptable."
 	});
 	for (const [partPath, content] of updates) {
-		const sourceEntry = zip.file(partPath);
-		if (sourceEntry === null) throw createEnsureParaIdsError(`Package part disappeared during normalization: ${partPath}`);
-		writeZipPart({
-			zip,
-			path: partPath,
-			data: encodeUtf8(content),
-			options: {
-				compression: "DEFLATE",
-				compressionOptions: { level: 6 },
-				date: sourceEntry.date
-			}
-		});
+		const sourceEntry = zip.entry(partPath);
+		if (sourceEntry === void 0) throw createEnsureParaIdsError(`Package part disappeared during normalization: ${partPath}`);
+		zip.set(partPath, content, { modified: sourceEntry.modified });
 	}
 	return {
-		docx: await zip.generateAsync({
-			type: "uint8array",
-			compression: "DEFLATE",
-			compressionOptions: { level: 6 }
-		}),
+		docx: await zip.generate({ level: 6 }),
 		assigned,
 		deduplicated,
 		alreadyComplete: false,
@@ -425,5 +410,4 @@ const ensureParaIds = async (docx, options = {}) => {
 		throw createEnsureParaIdsError(`Failed to normalize paragraph IDs: ${message}`, error);
 	}
 };
-//#endregion
 export { ENSURE_PARA_IDS_REASONS, EnsureParaIdsError, ensureParaIds };

package/dist/docx/fieldParser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
 import { StyleMap } from "./styleParser.js";
-//#region src/docx/fieldParser.d.ts
 /**
  * All known field types from OOXML specification
  */
@@ -242,5 +241,4 @@ export declare function getMergeFields(fields: document_d_exports.Field[]): docu
  * @param fields - Array of fields
  * @returns Array of merge field names
  */
-export declare function getMergeFieldNames(fields: document_d_exports.Field[]): string[];
-//#endregion
+export declare function getMergeFieldNames(fields: document_d_exports.Field[]): string[];

package/dist/docx/fieldParser.js

@@ -3,7 +3,7 @@ import { formatOoxmlCounter } from "./ooxmlCounterFormatter.js";
 import { FieldTypeSchema, narrowEnum } from "./parserEnums.js";
 import { parseRun } from "./runParser.js";
 import { findChildren, getAttribute } from "./xmlParser.js";
-//#region src/docx/fieldParser.ts
+// src/docx/fieldParser.ts
 /**
 * All known field types from OOXML specification
 */
@@ -612,5 +612,4 @@ function getMergeFieldNames(fields) {
 		return parseFieldInstruction(f.instruction).argument;
 	}).filter((name) => !!name);
 }
-//#endregion
 export { KNOWN_FIELD_TYPES, collectFields, computePageNumber, createComplexFieldContext, finalizeComplexField, formatDate, getFieldDisplayValue, getFieldsByType, getFormatSwitch, getMergeFieldNames, getMergeFields, getNumericPictureSwitch, getPageNumberFields, hasMergeFormat, isDateTimeField, isDocPropertyField, isHyperlinkField, isKnownFieldType, isMergeField, isPageNumberField, isReferenceField, isTocField, isTotalPagesField, parseFieldInstruction, parseFieldType, parseSimpleField, resetComplexFieldContext };

package/dist/docx/fieldState.d.ts

@@ -1,5 +1,4 @@
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/fieldState.d.ts
 /** What a field element states about its lock and dirty flags. */
 export type FieldState = {
   fldLock?: boolean;
@@ -21,5 +20,4 @@ export declare const fieldStateOf: ({ fldLock, dirty }: FieldState) => FieldStat
  * `1`/`0` is what Word writes and what the table, section and border
  * serializers write.
  */
-export declare const fieldStateAttributes: ({ fldLock, dirty }: FieldState) => string[];
-//#endregion
+export declare const fieldStateAttributes: ({ fldLock, dirty }: FieldState) => string[];

package/dist/docx/fieldState.js

@@ -1,5 +1,5 @@
 import { parseOnOffAttribute } from "./xmlParser.js";
-//#region src/docx/fieldState.ts
+// src/docx/fieldState.ts
 /**
 * `@w:fldLock` and `@w:dirty`, the two `ST_OnOff` attributes every field form
 * carries.
@@ -49,5 +49,4 @@ const fieldStateAttributes = ({ fldLock, dirty }) => {
 	if (dirty !== void 0) attrs.push(`w:dirty="${dirty ? "1" : "0"}"`);
 	return attrs;
 };
-//#endregion
 export { fieldStateAttributes, fieldStateOf, parseFieldState };

package/dist/docx/foldedListNumberFields.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/foldedListNumberFields.d.ts
 /** Whether `content` is markup that may stand between a field and the tab that follows it. */
 export declare const isListNumberGapMarker: (content: document_d_exports.ParagraphContent) => boolean;
 /** Whether `content` is a `LISTNUM` field, by its parsed type or its instruction. */
@@ -82,5 +81,4 @@ export declare const unfoldedListNumberContent: (content: document_d_exports.Par
  * stood for, and the marker shows exactly the fields still hidden behind it.
  * A capture under a tracked change is never hidden.
  */
-export declare const normalizeFoldedListNumbers: (paragraph: document_d_exports.Paragraph) => void;
-//#endregion
+export declare const normalizeFoldedListNumbers: (paragraph: document_d_exports.Paragraph) => void;

package/dist/docx/foldedListNumberFields.js

@@ -1,4 +1,4 @@
-//#region src/docx/foldedListNumberFields.ts
+// src/docx/foldedListNumberFields.ts
 /** Zero-width markup that can stand between a field and its tab. */
 const RANGE_MARKER_TYPES = /* @__PURE__ */ new Set([
 	"bookmarkStart",
@@ -265,5 +265,4 @@ const normalizeFoldedListNumbers = (paragraph) => {
 	paragraph.content = next;
 	if (rendering && state.showsFields) rendering.marker = listMarkerWithFold(state, plan.suffix);
 };
-//#endregion
 export { foldListNumberFields, foldedListNumberOf, isFoldedListNumber, isFoldedListNumberCapture, isListNumberField, isListNumberGapMarker, isTabOnlyRun, normalizeFoldedListNumbers, planListNumberFold, planParagraphListNumberFold, unfoldedListNumberContent };

package/dist/docx/fontTableParser.d.ts

@@ -1,4 +1,2 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/fontTableParser.d.ts
-export declare const parseFontTable: (xml: string | null | undefined) => document_d_exports.FontTable | undefined;
-//#endregion
+export declare const parseFontTable: (xml: string | null | undefined) => document_d_exports.FontTable | undefined;

package/dist/docx/fontTableParser.js

@@ -1,7 +1,7 @@
 import { DERIVED_PART_ROOT_ATTRIBUTES, attributeRemainder } from "./attributeRemainder.js";
 import { CAPTURE, dispatchChildrenWithContext } from "./containerChildren.js";
 import { getAttribute, parseXmlDocument } from "./xmlParser.js";
-//#region src/docx/fontTableParser.ts
+// src/docx/fontTableParser.ts
 const FONT_FAMILIES = [
 	"decorative",
 	"modern",
@@ -136,5 +136,4 @@ const FONT_HANDLERS = {
 	embedItalic: (child, walk) => read(walk, "embedItalic", embedOf(child)),
 	embedBoldItalic: (child, walk) => read(walk, "embedBoldItalic", embedOf(child))
 };
-//#endregion
 export { parseFontTable };

package/dist/docx/footnoteParser.d.ts

@@ -4,7 +4,6 @@ import { ParseContext } from "./parseContext.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertiesParser.js";
-//#region src/docx/footnoteParser.d.ts
 /**
  * Footnote map returned by parseFootnotes
  */
@@ -91,5 +90,4 @@ export declare function mergeFootnoteMaps(...maps: FootnoteMap[]): FootnoteMap;
  * Merge multiple endnote maps (e.g., from different documents)
  */
 export declare function mergeEndnoteMaps(...maps: EndnoteMap[]): EndnoteMap;
-//#endregion
 export { parseEndnoteProperties, parseFootnoteProperties };

package/dist/docx/footnoteParser.js

@@ -6,7 +6,7 @@ import { parseTable } from "./tableParser.js";
 import { captureVerbatimXml } from "./verbatimCapture.js";
 import { WORDPROCESSINGML_NAMESPACE_URIS, findChildren, findWordprocessingChild, getAttributes, getChildElements, getLocalName, parseXml } from "./xmlParser.js";
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
-//#region src/docx/footnoteParser.ts
+// src/docx/footnoteParser.ts
 /**
 * Footnote/Endnote Parser - Parse footnotes.xml and endnotes.xml
 *
@@ -261,5 +261,4 @@ function mergeEndnoteMaps(...maps) {
 	}
 	return createEndnoteMap(byId, endnotes);
 }
-//#endregion
 export { createEmptyEndnoteMap, createEmptyFootnoteMap, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };

package/dist/docx/graphicFrameLocks.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/graphicFrameLocks.d.ts
 /** Every modeled lock, in schema order: the total map above keeps it exhaustive. */
 export declare const GRAPHIC_FRAME_LOCK_KEYS: readonly (keyof document_d_exports.ImageFrameLocks)[];
 /**
@@ -29,5 +28,4 @@ export declare const FOLIO_INSERTED_PICTURE_FRAME_LOCKS: document_d_exports.Imag
  * path, where it would appear on every edited document and on none of the
  * replayed ones.
  */
-export declare const serializeGraphicFrameLocks: (locks: document_d_exports.ImageFrameLocks | undefined) => string;
-//#endregion
+export declare const serializeGraphicFrameLocks: (locks: document_d_exports.ImageFrameLocks | undefined) => string;

package/dist/docx/graphicFrameLocks.js

@@ -1,5 +1,5 @@
 import { findChild, getAttribute, parseOnOffValue } from "./xmlParser.js";
-//#region src/docx/graphicFrameLocks.ts
+// src/docx/graphicFrameLocks.ts
 /**
 * Model key → OOXML attribute. Insertion order is the schema's attribute
 * order, which is also the order we emit.
@@ -64,5 +64,4 @@ const serializeGraphicFrameLocks = (locks) => {
 	const attrList = attrs.length > 0 ? ` ${attrs.join(" ")}` : "";
 	return `<wp:cNvGraphicFramePr><a:graphicFrameLocks ${DRAWINGML_NAMESPACE}${attrList}/></wp:cNvGraphicFramePr>`;
 };
-//#endregion
 export { FOLIO_INSERTED_PICTURE_FRAME_LOCKS, GRAPHIC_FRAME_LOCK_KEYS, parseGraphicFrameLocks, serializeGraphicFrameLocks };

package/dist/docx/groupDrawingParser.d.ts

@@ -2,7 +2,6 @@ import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { GroupTextBoxFrame } from "./drawingGroupChildren.js";
-//#region src/docx/groupDrawingParser.d.ts
 /**
  * The text boxes a group preview does not draw, which the paragraph parser
  * lifts out as text boxes of their own. Undefined for any other image.
@@ -15,5 +14,4 @@ export declare const groupPreviewTextBoxes: (image: document_d_exports.Image) =>
  */
 export declare const isGroupDrawing: (drawing: XmlElement) => boolean;
 /** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
-export declare const parseGroupDrawing: (drawing: XmlElement, previews: PreviewLedger, rels?: document_d_exports.RelationshipMap, media?: Map<string, document_d_exports.MediaFile>) => document_d_exports.Image | null;
-//#endregion
+export declare const parseGroupDrawing: (drawing: XmlElement, previews: PreviewLedger, rels?: document_d_exports.RelationshipMap, media?: Map<string, document_d_exports.MediaFile>) => document_d_exports.Image | null;

package/dist/docx/groupDrawingParser.js

@@ -4,7 +4,7 @@ import { collectGroupTextBoxes, readTransform } from "./drawingGroupChildren.js"
 import { parseImage, resolveImageData } from "./imageParser.js";
 import { findAllDeep, findChildByLocalName, findChildrenByLocalName, getAttribute, getChildElements, getLocalName, getTextContent, parseNumericAttribute } from "./xmlParser.js";
 import { escapeXmlAttribute, escapeXmlText } from "@stll/docx-core";
-//#region src/docx/groupDrawingParser.ts
+// src/docx/groupDrawingParser.ts
 const HEX_COLOR = /^[0-9A-Fa-f]{6}$/u;
 const DEFAULT_TEXT_COLOR = "000000";
 const DEFAULT_FONT_HALF_POINTS = 22;
@@ -296,5 +296,4 @@ const parseGroupDrawing = (drawing, previews, rels, media) => {
 	if (hosted.length > 0) hostedTextBoxFrames.set(preview, hosted);
 	return preview;
 };
-//#endregion
 export { groupPreviewTextBoxes, isGroupDrawing, parseGroupDrawing };

package/dist/docx/headerFooterParser.d.ts

@@ -3,7 +3,6 @@ import { NumberingMap } from "./numberingParser.js";
 import { PreviewLedger } from "./previewBudget.js";
 import { StyleMap } from "./styleParser.js";
 import { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences } from "./headerFooterRefParser.js";
-//#region src/docx/headerFooterParser.d.ts
 /**
  * Map of header/footer ID to HeaderFooter content
  */
@@ -120,5 +119,4 @@ export declare function hasImages(hf: document_d_exports.HeaderFooter): boolean;
  * Check if a HeaderFooter contains any tables
  */
 export declare function hasTables(hf: document_d_exports.HeaderFooter): boolean;
-//#endregion
 export { parseFooterReference, parseFooterReferences, parseHeaderReference, parseHeaderReferences };

package/dist/docx/headerFooterParser.js

@@ -5,7 +5,7 @@ import { cloneParagraphWithPropertySource } from "./paragraphPropertySource.js";
 import { standalonePreviewLedger } from "./previewBudget.js";
 import { parseWatermark } from "./watermarkParser.js";
 import { collectXmlnsDeclarations, getLocalName, parseXml } from "./xmlParser.js";
-//#region src/docx/headerFooterParser.ts
+// src/docx/headerFooterParser.ts
 /**
 * Parse a header XML file (word/header*.xml)
 *
@@ -242,5 +242,4 @@ function hasTables(hf) {
 	for (const item of hf.content) if (item.type === "table") return true;
 	return false;
 }
-//#endregion
 export { buildHeaderFooterMap, createEmptyHeaderFooterMap, getFooterForPage, getHeaderForPage, hasImages, hasPageNumberField, hasTables, headerFooterMapToTypeMap, isEmptyHeaderFooter, parseFooter, parseFooterReference, parseFooterReferences, parseHeader, parseHeaderFooter, parseHeaderReference, parseHeaderReferences };

package/dist/docx/headerFooterRefParser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { ParseContext } from "./parseContext.js";
 import { XmlElement } from "./xmlParser.js";
-//#region src/docx/headerFooterRefParser.d.ts
 /**
  * Read a `w:type` attribute as one of ECMA-376's three `ST_HdrFtr` values.
  *
@@ -28,5 +27,4 @@ export declare function parseHeaderReferences(sectPr: XmlElement): document_d_ex
 /**
  * Parse all footer references from a sectPr element
  */
-export declare function parseFooterReferences(sectPr: XmlElement): document_d_exports.FooterReference[];
-//#endregion
+export declare function parseFooterReferences(sectPr: XmlElement): document_d_exports.FooterReference[];

package/dist/docx/headerFooterRefParser.js

@@ -1,6 +1,6 @@
 import { findChildren, getAttribute } from "./xmlParser.js";
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
-//#region src/docx/headerFooterRefParser.ts
+// src/docx/headerFooterRefParser.ts
 /**
 * Header/Footer Reference Parser
 *
@@ -85,5 +85,4 @@ function parseFooterReferences(sectPr) {
 	}
 	return refs;
 }
-//#endregion
 export { parseFooterReference, parseFooterReferences, parseHeaderFooterType, parseHeaderReference, parseHeaderReferences };

package/dist/docx/headerFooterReferenceNormalization.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-//#region src/docx/headerFooterReferenceNormalization.d.ts
 /** The codes this normalisation is reported under, owned here, not at the caller. */
 export declare const DANGLING_HEADER_REFERENCE_WARNING: "dangling-header-reference";
 export declare const DANGLING_FOOTER_REFERENCE_WARNING: "dangling-footer-reference";
@@ -32,5 +31,4 @@ type AssignHeaderFooterRolesInput = {
  * needs every role reads the section references themselves.
  */
 export declare const assignHeaderFooterRoles: ({ documentBody, headers, footers }: AssignHeaderFooterRolesInput) => void;
-//#endregion
 export {};

package/dist/docx/headerFooterReferenceNormalization.js

@@ -1,5 +1,5 @@
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
-//#region src/docx/headerFooterReferenceNormalization.ts
+// src/docx/headerFooterReferenceNormalization.ts
 /** The codes this normalisation is reported under, owned here, not at the caller. */
 const DANGLING_HEADER_REFERENCE_WARNING = PARSE_WARNING_CODES.danglingHeaderReference;
 const DANGLING_FOOTER_REFERENCE_WARNING = PARSE_WARNING_CODES.danglingFooterReference;
@@ -90,5 +90,4 @@ const removeDanglingReferences = (references, validParts) => {
 		removed: references.length - kept.length
 	};
 };
-//#endregion
 export { DANGLING_FOOTER_REFERENCE_WARNING, DANGLING_HEADER_REFERENCE_WARNING, assignHeaderFooterRoles, normalizeHeaderFooterReferences };