@stll/folio-core 0.62.0 → 0.63.0

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

@@ -1,18 +1,18 @@
 //#region src/docx/encryption/errors.d.ts
 /** Machine-readable codes for password-protected OOXML failures. */
-declare const DOCX_ENCRYPTION_ERROR_CODES: {
+export declare const DOCX_ENCRYPTION_ERROR_CODES: {
   readonly PASSWORD_REQUIRED: "DOCX_PASSWORD_REQUIRED";
   readonly PASSWORD_INVALID: "DOCX_PASSWORD_INVALID";
   readonly ENCRYPTION_UNSUPPORTED: "DOCX_ENCRYPTION_UNSUPPORTED";
   readonly DECRYPTION_FAILED: "DOCX_DECRYPTION_FAILED";
 };
-type DocxEncryptionErrorCode = (typeof DOCX_ENCRYPTION_ERROR_CODES)[keyof typeof DOCX_ENCRYPTION_ERROR_CODES];
+export type DocxEncryptionErrorCode = (typeof DOCX_ENCRYPTION_ERROR_CODES)[keyof typeof DOCX_ENCRYPTION_ERROR_CODES];
 declare const DocxEncryptionError_base: import("better-result").TaggedErrorClass<"DocxEncryptionError">;
-declare class DocxEncryptionError extends DocxEncryptionError_base<{
+export declare class DocxEncryptionError extends DocxEncryptionError_base<{
   message: string;
   code: DocxEncryptionErrorCode;
   cause?: unknown;
 }> {}
-declare const isDocxEncryptionError: (error: unknown) => error is DocxEncryptionError;
+export declare const isDocxEncryptionError: (error: unknown) => error is DocxEncryptionError;
 //#endregion
-export { DOCX_ENCRYPTION_ERROR_CODES, DocxEncryptionError, DocxEncryptionErrorCode, isDocxEncryptionError };
+export {};

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

@@ -6,11 +6,11 @@
  *
  * @see https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-offcrypto/
  */
-type DecryptDocxOptions = {
+export type DecryptDocxOptions = {
   /** Password for Agile-encrypted .docx files (Office 2010+). */
   password?: string | undefined;
 };
-type DecryptDocxResult = {
+export type DecryptDocxResult = {
   /** Plaintext OOXML ZIP bytes, or the original buffer when unencrypted. */
   data: ArrayBuffer;
   /** True when the input was an encrypted CFB container and decryption ran. */
@@ -24,8 +24,7 @@ type DecryptDocxResult = {
  *
  * Save produces a standard unencrypted OOXML ZIP; folio does not re-encrypt on export.
  */
-declare const decryptDocxIfNeeded: (data: ArrayBuffer | Uint8Array, options?: DecryptDocxOptions) => Promise<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. */
-declare const openDocxBuffer: (data: ArrayBuffer | Uint8Array, options?: DecryptDocxOptions) => Promise<ArrayBuffer>;
-//#endregion
-export { DecryptDocxOptions, DecryptDocxResult, decryptDocxIfNeeded, openDocxBuffer };
+export declare const openDocxBuffer: (data: ArrayBuffer | Uint8Array, options?: DecryptDocxOptions) => Promise<ArrayBuffer>;
+//#endregion

package/dist/docx/ensureParaIds.d.ts

@@ -1,18 +1,18 @@
 //#region src/docx/ensureParaIds.d.ts
-declare const ENSURE_PARA_IDS_REASONS: {
+export declare const ENSURE_PARA_IDS_REASONS: {
   readonly NORMALIZATION_FAILED: "normalization-failed";
   readonly NAMESPACE_INVALID: "namespace-invalid";
   readonly SIGNED_PACKAGE: "signed-package";
 };
 declare const EnsureParaIdsError_base: import("better-result").TaggedErrorClass<"EnsureParaIdsError">;
 /** A malformed or unsupported package prevented paragraph-ID normalization. */
-declare class EnsureParaIdsError extends EnsureParaIdsError_base<{
+export declare class EnsureParaIdsError extends EnsureParaIdsError_base<{
   message: string;
   reason: (typeof ENSURE_PARA_IDS_REASONS)[keyof typeof ENSURE_PARA_IDS_REASONS];
   cause?: unknown;
 }> {}
 /** Counts and normalized bytes returned by {@link ensureParaIds}. */
-type EnsureParaIdsResult = {
+export type EnsureParaIdsResult = {
   /** The normalized `.docx`; the input bytes verbatim when `alreadyComplete`. */
   docx: Uint8Array;
   /** Paragraphs that received a paraId (missing or all-zero before). */
@@ -28,7 +28,7 @@ type EnsureParaIdsResult = {
   mintedParaIds: readonly string[];
 };
 /** Controls mutation of package metadata that has security implications. */
-type EnsureParaIdsOptions = {
+export type EnsureParaIdsOptions = {
   /**
    * Allow normalization to invalidate existing OPC digital signatures.
    * Callers must warn the user before opting in.
@@ -39,6 +39,6 @@ type EnsureParaIdsOptions = {
  * Backfill `w14:paraId` on every paragraph of a `.docx` buffer. All package,
  * XML, and compression failures are surfaced as {@link EnsureParaIdsError}.
  */
-declare const ensureParaIds: (docx: Uint8Array | ArrayBuffer, options?: EnsureParaIdsOptions) => Promise<EnsureParaIdsResult>;
+export declare const ensureParaIds: (docx: Uint8Array | ArrayBuffer, options?: EnsureParaIdsOptions) => Promise<EnsureParaIdsResult>;
 //#endregion
-export { ENSURE_PARA_IDS_REASONS, EnsureParaIdsError, EnsureParaIdsOptions, EnsureParaIdsResult, ensureParaIds };
+export {};

package/dist/docx/ensureParaIds.js

@@ -7,8 +7,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 { writeZipPart } from "@stll/docx-core/zip";
 import JSZip from "jszip";
+import { writeZipPart } from "@stll/docx-core/zip";
 //#region src/docx/ensureParaIds.ts
 /**
 * Headless `w14:paraId` normalization for a `.docx` buffer.

package/dist/docx/fieldParser.d.ts

@@ -5,7 +5,7 @@ import { StyleMap } from "./styleParser.js";
 /**
  * All known field types from OOXML specification
  */
-declare const KNOWN_FIELD_TYPES: readonly document_d_exports.FieldType[];
+export declare const KNOWN_FIELD_TYPES: readonly document_d_exports.FieldType[];
 /**
  * Parse field type from instruction string
  *
@@ -19,7 +19,7 @@ declare const KNOWN_FIELD_TYPES: readonly document_d_exports.FieldType[];
  * @param instruction - The field instruction string
  * @returns The detected field type
  */
-declare function parseFieldType(instruction: string): document_d_exports.FieldType;
+export declare function parseFieldType(instruction: string): document_d_exports.FieldType;
 /**
  * Check if a field type is a known type. The sentinel "UNKNOWN" value
  * is not considered a "known" type even though it belongs to FieldType.
@@ -27,11 +27,11 @@ declare function parseFieldType(instruction: string): document_d_exports.FieldTy
  * @param type - Field type string to check
  * @returns true if it's a known field type
  */
-declare function isKnownFieldType(type: string): type is document_d_exports.FieldType;
+export declare function isKnownFieldType(type: string): type is document_d_exports.FieldType;
 /**
  * Parsed field instruction with arguments and switches
  */
-type ParsedFieldInstruction = {
+export type ParsedFieldInstruction = {
   /** Field type */
   type: document_d_exports.FieldType;
   /** Raw instruction string */
@@ -44,7 +44,7 @@ type ParsedFieldInstruction = {
 /**
  * Field switch parsed from instruction
  */
-type FieldSwitch = {
+export type FieldSwitch = {
   /** Switch character (e.g., '*', '@', '#', 'h', 'p') */
   switch: string;
   /** Switch value if any */
@@ -56,28 +56,28 @@ type FieldSwitch = {
  * @param instruction - Raw instruction string
  * @returns Parsed instruction object
  */
-declare function parseFieldInstruction(instruction: string): ParsedFieldInstruction;
+export declare function parseFieldInstruction(instruction: string): ParsedFieldInstruction;
 /**
  * Get the format switch value (\* or \@)
  *
  * @param instruction - Parsed instruction
  * @returns Format string or undefined
  */
-declare function getFormatSwitch(instruction: ParsedFieldInstruction): string | undefined;
+export declare function getFormatSwitch(instruction: ParsedFieldInstruction): string | undefined;
 /**
  * Get the numeric picture switch value (\#), e.g. `0#` in `PAGE \# 0#`.
  *
  * @param instruction - Parsed instruction
  * @returns Picture string or undefined
  */
-declare function getNumericPictureSwitch(instruction: ParsedFieldInstruction): string | undefined;
+export declare function getNumericPictureSwitch(instruction: ParsedFieldInstruction): string | undefined;
 /**
  * Check if field has MERGEFORMAT switch (preserve formatting)
  *
  * @param instruction - Parsed instruction
  * @returns true if MERGEFORMAT is present
  */
-declare function hasMergeFormat(instruction: ParsedFieldInstruction): boolean;
+export declare function hasMergeFormat(instruction: ParsedFieldInstruction): boolean;
 /**
  * Parse a simple field element (w:fldSimple)
  *
@@ -86,15 +86,15 @@ declare function hasMergeFormat(instruction: ParsedFieldInstruction): boolean;
  * @param theme - Theme for color/font resolution
  * @returns Parsed SimpleField object
  */
-declare function parseSimpleField(node: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null): document_d_exports.SimpleField;
+export declare function parseSimpleField(node: XmlElement, styles: StyleMap | null, theme: document_d_exports.Theme | null): document_d_exports.SimpleField;
 /**
  * State machine for tracking complex field parsing
  */
-type ComplexFieldState = "outside" | "code" | "result";
+export type ComplexFieldState = "outside" | "code" | "result";
 /**
  * Complex field parsing context
  */
-type ComplexFieldContext = {
+export type ComplexFieldContext = {
   /** Current state */
   state: ComplexFieldState;
   /** Accumulated instruction text */
@@ -113,81 +113,81 @@ type ComplexFieldContext = {
 /**
  * Create a new complex field context
  */
-declare function createComplexFieldContext(): ComplexFieldContext;
+export declare function createComplexFieldContext(): ComplexFieldContext;
 /**
  * Reset the context for a new field
  */
-declare function resetComplexFieldContext(ctx: ComplexFieldContext): void;
+export declare function resetComplexFieldContext(ctx: ComplexFieldContext): void;
 /**
  * Finalize a complex field from its context
  *
  * @param ctx - The field context
  * @returns The parsed ComplexField
  */
-declare function finalizeComplexField(ctx: ComplexFieldContext): document_d_exports.ComplexField;
+export declare function finalizeComplexField(ctx: ComplexFieldContext): document_d_exports.ComplexField;
 /**
  * Get the current display value of a field
  *
  * @param field - The field (simple or complex)
  * @returns The display text
  */
-declare function getFieldDisplayValue(field: document_d_exports.Field): string;
+export declare function getFieldDisplayValue(field: document_d_exports.Field): string;
 /**
  * Check if field represents a page number
  *
  * @param field - The field to check
  * @returns true if this is a page number field
  */
-declare function isPageNumberField(field: document_d_exports.Field): boolean;
+export declare function isPageNumberField(field: document_d_exports.Field): boolean;
 /**
  * Check if field represents total page count
  *
  * @param field - The field to check
  * @returns true if this is a total pages field
  */
-declare function isTotalPagesField(field: document_d_exports.Field): boolean;
+export declare function isTotalPagesField(field: document_d_exports.Field): boolean;
 /**
  * Check if field is a date/time field
  *
  * @param field - The field to check
  * @returns true if this is a date/time field
  */
-declare function isDateTimeField(field: document_d_exports.Field): boolean;
+export declare function isDateTimeField(field: document_d_exports.Field): boolean;
 /**
  * Check if field is a document property field
  *
  * @param field - The field to check
  * @returns true if this is a document property field
  */
-declare function isDocPropertyField(field: document_d_exports.Field): boolean;
+export declare function isDocPropertyField(field: document_d_exports.Field): boolean;
 /**
  * Check if field is a cross-reference field
  *
  * @param field - The field to check
  * @returns true if this is a cross-reference field
  */
-declare function isReferenceField(field: document_d_exports.Field): boolean;
+export declare function isReferenceField(field: document_d_exports.Field): boolean;
 /**
  * Check if field is a mail merge field
  *
  * @param field - The field to check
  * @returns true if this is a mail merge field
  */
-declare function isMergeField(field: document_d_exports.Field): boolean;
+export declare function isMergeField(field: document_d_exports.Field): boolean;
 /**
  * Check if field is a hyperlink field
  *
  * @param field - The field to check
  * @returns true if this is a hyperlink field
  */
-declare function isHyperlinkField(field: document_d_exports.Field): boolean;
+export declare function isHyperlinkField(field: document_d_exports.Field): boolean;
 /**
  * Check if field is a TOC/Index field
  *
  * @param field - The field to check
  * @returns true if this is a TOC or index field
  */
-declare function isTocField(field: document_d_exports.Field): boolean;
+export declare function isTocField(field: document_d_exports.Field): boolean;
 /**
  * Compute the value for a page number field
  *
@@ -195,7 +195,7 @@ declare function isTocField(field: document_d_exports.Field): boolean;
  * @param instruction - Parsed instruction for format switches
  * @returns Formatted page number string
  */
-declare function computePageNumber(pageNumber: number, instruction?: ParsedFieldInstruction, sectionFormat?: document_d_exports.NumberFormat): string;
+export declare function computePageNumber(pageNumber: number, instruction?: ParsedFieldInstruction, sectionFormat?: document_d_exports.NumberFormat): string;
 /**
  * Format a date according to a format string
  *
@@ -212,8 +212,8 @@ declare function computePageNumber(pageNumber: number, instruction?: ParsedField
  * @param format - The format string
  * @returns Formatted date string
  */
-declare function formatDate(date: Date, format: string): string;
-declare function collectFields(content: unknown[]): document_d_exports.Field[];
+export declare function formatDate(date: Date, format: string): string;
+export declare function collectFields(content: unknown[]): document_d_exports.Field[];
 /**
  * Get all fields of a specific type
  *
@@ -221,27 +221,26 @@ declare function collectFields(content: unknown[]): document_d_exports.Field[];
  * @param fieldType - The field type to filter by
  * @returns Filtered array of fields
  */
-declare function getFieldsByType(fields: document_d_exports.Field[], fieldType: document_d_exports.FieldType): document_d_exports.Field[];
+export declare function getFieldsByType(fields: document_d_exports.Field[], fieldType: document_d_exports.FieldType): document_d_exports.Field[];
 /**
  * Find all page number fields
  *
  * @param fields - Array of fields
  * @returns Array of PAGE fields
  */
-declare function getPageNumberFields(fields: document_d_exports.Field[]): document_d_exports.Field[];
+export declare function getPageNumberFields(fields: document_d_exports.Field[]): document_d_exports.Field[];
 /**
  * Find all merge fields
  *
  * @param fields - Array of fields
  * @returns Array of MERGEFIELD fields
  */
-declare function getMergeFields(fields: document_d_exports.Field[]): document_d_exports.Field[];
+export declare function getMergeFields(fields: document_d_exports.Field[]): document_d_exports.Field[];
 /**
  * Extract merge field names from fields
  *
  * @param fields - Array of fields
  * @returns Array of merge field names
  */
-declare function getMergeFieldNames(fields: document_d_exports.Field[]): string[];
-//#endregion
-export { ComplexFieldContext, ComplexFieldState, FieldSwitch, KNOWN_FIELD_TYPES, ParsedFieldInstruction, 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 };
+export declare function getMergeFieldNames(fields: document_d_exports.Field[]): string[];
+//#endregion

package/dist/docx/fieldParser.js

@@ -77,7 +77,8 @@ function parseFieldType(instruction) {
 	const trimmed = instruction.trim();
 	const match = /^\\?(?<name>[A-Z][A-Z0-9]*)/iu.exec(trimmed);
 	if (!match) return "UNKNOWN";
-	return narrowEnum(match.groups["name"].toUpperCase(), FieldTypeSchema) ?? "UNKNOWN";
+	const fieldName = match.groups["name"].toUpperCase();
+	return narrowEnum(fieldName, FieldTypeSchema) ?? "UNKNOWN";
 }
 /**
 * Check if a field type is a known type. The sentinel "UNKNOWN" value
@@ -401,11 +402,12 @@ function applyNumericPicture(value, picture) {
 	let digitIndex = digits.length - 1;
 	for (let i = pictureChars.length - 1; i >= 0; i--) {
 		const char = pictureChars[i];
-		if (char === "0" || char === "#") if (digitIndex >= 0) {
-			output[i] = digits[digitIndex];
-			digitIndex--;
-		} else output[i] = char === "0" ? "0" : "";
-		else output[i] = char;
+		if (char === "0" || char === "#") {
+			if (digitIndex >= 0) {
+				output[i] = digits[digitIndex];
+				digitIndex--;
+			} else output[i] = char === "0" ? "0" : "";
+		} else output[i] = char;
 	}
 	const overflow = digitIndex >= 0 ? digits.slice(0, digitIndex + 1).join("") : "";
 	return (negative ? "-" : "") + overflow + output.join("");

package/dist/docx/fieldState.d.ts

@@ -1,12 +1,12 @@
 import { XmlElement } from "./xmlParser.js";
 //#region src/docx/fieldState.d.ts
 /** What a field element states about its lock and dirty flags. */
-type FieldState = {
+export type FieldState = {
   fldLock?: boolean;
   dirty?: boolean;
 };
 /** Read both attributes off a `w:fldSimple` or `w:fldChar`, keeping an explicit off. */
-declare const parseFieldState: (element: XmlElement) => FieldState;
+export declare const parseFieldState: (element: XmlElement) => FieldState;
 /**
  * The stated flags of a field, without the rest of it.
  *
@@ -14,13 +14,12 @@ declare const parseFieldState: (element: XmlElement) => FieldState;
  * runs between `begin` and `end`, and this is the one place that knows which
  * fields that state is made of.
  */
-declare const fieldStateOf: ({ fldLock, dirty }: FieldState) => FieldState;
+export declare const fieldStateOf: ({ fldLock, dirty }: FieldState) => FieldState;
 /**
  * The attributes to write for a field's stated flags, in schema order.
  *
  * `1`/`0` is what Word writes and what the table, section and border
  * serializers write.
  */
-declare const fieldStateAttributes: ({ fldLock, dirty }: FieldState) => string[];
-//#endregion
-export { FieldState, fieldStateAttributes, fieldStateOf, parseFieldState };
+export declare const fieldStateAttributes: ({ fldLock, dirty }: FieldState) => string[];
+//#endregion

package/dist/docx/foldedListNumberFields.d.ts

@@ -1,18 +1,18 @@
 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. */
-declare const isListNumberGapMarker: (content: document_d_exports.ParagraphContent) => boolean;
+export declare const isListNumberGapMarker: (content: document_d_exports.ParagraphContent) => boolean;
 /** Whether `content` is a `LISTNUM` field, by its parsed type or its instruction. */
-declare const isListNumberField: (content: document_d_exports.ParagraphContent) => content is document_d_exports.ComplexField;
+export declare const isListNumberField: (content: document_d_exports.ParagraphContent) => content is document_d_exports.ComplexField;
 /** A run that holds one tab and nothing else. */
-declare const isTabOnlyRun: (content: document_d_exports.ParagraphContent) => content is document_d_exports.Run;
+export declare const isTabOnlyRun: (content: document_d_exports.ParagraphContent) => content is document_d_exports.Run;
 /** Whether `value` is what a capture stands for: a complex field, or a run. */
-declare const isFoldedListNumber: (value: unknown) => value is document_d_exports.FoldedListNumber;
+export declare const isFoldedListNumber: (value: unknown) => value is document_d_exports.FoldedListNumber;
 /** What `content` stands for when it is a capture the fold left, else nothing. */
-declare const foldedListNumberOf: (content: document_d_exports.ParagraphContent) => document_d_exports.FoldedListNumber | undefined;
+export declare const foldedListNumberOf: (content: document_d_exports.ParagraphContent) => document_d_exports.FoldedListNumber | undefined;
 /** Whether `content` is a capture the fold left in place of a field or its tab. */
-declare const isFoldedListNumberCapture: (content: document_d_exports.ParagraphContent) => boolean;
-type ListNumberFieldFold = {
+export declare const isFoldedListNumberCapture: (content: document_d_exports.ParagraphContent) => boolean;
+export type ListNumberFieldFold = {
   /** The content, each folded field and its tab replaced by a capture. */
   content: document_d_exports.ParagraphContent[];
   /** The cached display of each folded field that has one, in source order. */
@@ -30,9 +30,9 @@ type ListNumberFieldFold = {
  * fold. Bookmark and comment markers between a field and its tab stay where
  * they are, and the tab is still the field's when only they separate the two.
  */
-declare const foldListNumberFields: (content: readonly document_d_exports.ParagraphContent[], sourceMarkupOf: (item: document_d_exports.ComplexField | document_d_exports.Run) => string | undefined) => ListNumberFieldFold;
+export declare const foldListNumberFields: (content: readonly document_d_exports.ParagraphContent[], sourceMarkupOf: (item: document_d_exports.ComplexField | document_d_exports.Run) => string | undefined) => ListNumberFieldFold;
 /** One item of a paragraph, as far as the fold needs to know it. */
-type ListNumberFoldItem =
+export type ListNumberFoldItem =
 /** A capture of a field, with the text its cached result shows. */
 {
   kind: "field";
@@ -50,7 +50,7 @@ type ListNumberFoldItem =
 {
   kind: "shown";
 };
-type ListNumberFoldPlan = {
+export type ListNumberFoldPlan = {
   /** The items' indices in the order they are to stand in. */
   order: number[];
   /** Indices of the captures that stay hidden; every other capture goes on the line. */
@@ -71,17 +71,16 @@ type ListNumberFoldPlan = {
  * and the captures that stand with it go back to the start. Every capture
  * further in is on the line.
  */
-declare const planListNumberFold: (items: readonly ListNumberFoldItem[], markerShowsFields: boolean) => ListNumberFoldPlan;
+export declare const planListNumberFold: (items: readonly ListNumberFoldItem[], markerShowsFields: boolean) => ListNumberFoldPlan;
 /** Derive the marker fold from current captures, never from cached rendering. */
-declare const planParagraphListNumberFold: (content: readonly document_d_exports.ParagraphContent[], showsFields: boolean) => ListNumberFoldPlan;
+export declare const planParagraphListNumberFold: (content: readonly document_d_exports.ParagraphContent[], showsFields: boolean) => ListNumberFoldPlan;
 /** The item a capture stands for, which shows on the line; any other item is itself. */
-declare const unfoldedListNumberContent: (content: document_d_exports.ParagraphContent) => document_d_exports.ParagraphContent;
+export declare const unfoldedListNumberContent: (content: document_d_exports.ParagraphContent) => document_d_exports.ParagraphContent;
 /**
  * Bring `paragraph` to the one form the fold allows: the captures its marker
  * shows stand at its start, every other capture is the field or the tab it
  * stood for, and the marker shows exactly the fields still hidden behind it.
  * A capture under a tracked change is never hidden.
  */
-declare const normalizeFoldedListNumbers: (paragraph: document_d_exports.Paragraph) => void;
-//#endregion
-export { ListNumberFieldFold, ListNumberFoldItem, ListNumberFoldPlan, foldListNumberFields, foldedListNumberOf, isFoldedListNumber, isFoldedListNumberCapture, isListNumberField, isListNumberGapMarker, isTabOnlyRun, normalizeFoldedListNumbers, planListNumberFold, planParagraphListNumberFold, unfoldedListNumberContent };
+export declare const normalizeFoldedListNumbers: (paragraph: document_d_exports.Paragraph) => void;
+//#endregion

package/dist/docx/fontTableParser.d.ts

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

package/dist/docx/footnoteParser.d.ts

@@ -8,7 +8,7 @@ import { parseEndnoteProperties, parseFootnoteProperties } from "./notePropertie
 /**
  * Footnote map returned by parseFootnotes
  */
-type FootnoteMap = {
+export type FootnoteMap = {
   /** All footnotes indexed by ID */
   byId: Map<number, document_d_exports.Footnote>;
   /** Array of all footnotes in document order */
@@ -27,7 +27,7 @@ type FootnoteMap = {
 /**
  * Endnote map returned by parseEndnotes
  */
-type EndnoteMap = {
+export type EndnoteMap = {
   /** All endnotes indexed by ID */
   byId: Map<number, document_d_exports.Endnote>;
   /** Array of all endnotes in document order */
@@ -54,7 +54,7 @@ type EndnoteMap = {
  * @param media - Media files for images
  * @returns FootnoteMap with all footnotes
  */
-declare function parseFootnotes(footnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext, previews?: PreviewLedger): FootnoteMap;
+export declare function parseFootnotes(footnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext, previews?: PreviewLedger): FootnoteMap;
 /**
  * Parse endnotes.xml
  *
@@ -66,30 +66,30 @@ declare function parseFootnotes(footnotesXml: string | null, styles?: StyleMap |
  * @param media - Media files for images
  * @returns EndnoteMap with all endnotes
  */
-declare function parseEndnotes(endnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext, previews?: PreviewLedger): EndnoteMap;
+export declare function parseEndnotes(endnotesXml: string | null, styles?: StyleMap | null, theme?: document_d_exports.Theme | null, numbering?: NumberingMap | null, rels?: document_d_exports.RelationshipMap | null, media?: Map<string, document_d_exports.MediaFile> | null, context?: ParseContext, previews?: PreviewLedger): EndnoteMap;
 /**
  * Check if a footnote is a separator (not regular content)
  */
-declare function isSeparatorFootnote(footnote: document_d_exports.Footnote): boolean;
+export declare function isSeparatorFootnote(footnote: document_d_exports.Footnote): boolean;
 /**
  * Check if an endnote is a separator (not regular content)
  */
-declare function isSeparatorEndnote(endnote: document_d_exports.Endnote): boolean;
+export declare function isSeparatorEndnote(endnote: document_d_exports.Endnote): boolean;
 /**
  * Create an empty footnote map
  */
-declare function createEmptyFootnoteMap(): FootnoteMap;
+export declare function createEmptyFootnoteMap(): FootnoteMap;
 /**
  * Create an empty endnote map
  */
-declare function createEmptyEndnoteMap(): EndnoteMap;
+export declare function createEmptyEndnoteMap(): EndnoteMap;
 /**
  * Merge multiple footnote maps (e.g., from different documents)
  */
-declare function mergeFootnoteMaps(...maps: FootnoteMap[]): FootnoteMap;
+export declare function mergeFootnoteMaps(...maps: FootnoteMap[]): FootnoteMap;
 /**
  * Merge multiple endnote maps (e.g., from different documents)
  */
-declare function mergeEndnoteMaps(...maps: EndnoteMap[]): EndnoteMap;
+export declare function mergeEndnoteMaps(...maps: EndnoteMap[]): EndnoteMap;
 //#endregion
-export { EndnoteMap, FootnoteMap, createEmptyEndnoteMap, createEmptyFootnoteMap, isSeparatorEndnote, isSeparatorFootnote, mergeEndnoteMaps, mergeFootnoteMaps, parseEndnoteProperties, parseEndnotes, parseFootnoteProperties, parseFootnotes };
+export { parseEndnoteProperties, parseFootnoteProperties };

package/dist/docx/footnoteParser.js

@@ -8,6 +8,25 @@ import { WORDPROCESSINGML_NAMESPACE_URIS, findChildren, findWordprocessingChild,
 import { PARSE_WARNING_CODES } from "@stll/docx-core/model";
 //#region src/docx/footnoteParser.ts
 /**
+* Footnote/Endnote Parser - Parse footnotes.xml and endnotes.xml
+*
+* Footnotes and endnotes are stored in separate XML files within the DOCX package:
+* - word/footnotes.xml - Contains all footnote definitions
+* - word/endnotes.xml - Contains all endnote definitions
+*
+* Each note contains:
+* - An ID that matches references in document.xml (w:footnoteReference, w:endnoteReference)
+* - A type (normal, separator, continuationSeparator, continuationNotice)
+* - Content (paragraphs)
+*
+* The references in the document body are parsed by runParser as NoteReferenceContent.
+*
+* OOXML Reference:
+* - Footnote: w:footnote[@w:id][@w:type]
+* - Endnote: w:endnote[@w:id][@w:type]
+* - Content: w:p (paragraphs)
+*/
+/**
 * Parse note type attribute
 */
 function parseNoteType(typeAttr) {

package/dist/docx/graphicFrameLocks.d.ts

@@ -2,7 +2,7 @@ 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. */
-declare const GRAPHIC_FRAME_LOCK_KEYS: ("noGrp" | "noDrilldown" | "noSelect" | "noChangeAspect" | "noMove" | "noResize")[];
+export declare const GRAPHIC_FRAME_LOCK_KEYS: readonly (keyof document_d_exports.ImageFrameLocks)[];
 /**
  * Read the locks off a `wp:inline` or `wp:anchor` element.
  *
@@ -10,7 +10,7 @@ declare const GRAPHIC_FRAME_LOCK_KEYS: ("noGrp" | "noDrilldown" | "noSelect" | "
  * attribute: an authored `<a:graphicFrameLocks/>` with nothing on it means the
  * same as no element at all, so both stay "spec defaults" on the model.
  */
-declare const parseGraphicFrameLocks: (parent: XmlElement) => document_d_exports.ImageFrameLocks | undefined;
+export declare const parseGraphicFrameLocks: (parent: XmlElement) => document_d_exports.ImageFrameLocks | undefined;
 /**
  * The locks folio gives a picture it creates itself, at the insert that creates
  * it: Word writes `noChangeAspect="1"` on a picture inserted through its own
@@ -20,7 +20,7 @@ declare const parseGraphicFrameLocks: (parent: XmlElement) => document_d_exports
  * construction rather than at serialization, where "the author wrote no frame"
  * and "folio made this picture" are the same `undefined`.
  */
-declare const FOLIO_INSERTED_PICTURE_FRAME_LOCKS: document_d_exports.ImageFrameLocks;
+export declare const FOLIO_INSERTED_PICTURE_FRAME_LOCKS: document_d_exports.ImageFrameLocks;
 /**
  * Emit `wp:cNvGraphicFramePr` for regenerated DrawingML, or nothing.
  *
@@ -29,6 +29,5 @@ declare const FOLIO_INSERTED_PICTURE_FRAME_LOCKS: document_d_exports.ImageFrameL
  * path, where it would appear on every edited document and on none of the
  * replayed ones.
  */
-declare const serializeGraphicFrameLocks: (locks: document_d_exports.ImageFrameLocks | undefined) => string;
-//#endregion
-export { FOLIO_INSERTED_PICTURE_FRAME_LOCKS, GRAPHIC_FRAME_LOCK_KEYS, parseGraphicFrameLocks, serializeGraphicFrameLocks };
+export declare const serializeGraphicFrameLocks: (locks: document_d_exports.ImageFrameLocks | undefined) => string;
+//#endregion

package/dist/docx/groupDrawingParser.d.ts

@@ -7,14 +7,13 @@ import { GroupTextBoxFrame } from "./drawingGroupChildren.js";
  * 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.
  */
-declare const groupPreviewTextBoxes: (image: document_d_exports.Image) => readonly GroupTextBoxFrame[] | undefined;
+export declare const groupPreviewTextBoxes: (image: document_d_exports.Image) => readonly GroupTextBoxFrame[] | undefined;
 /**
  * Whether a `w:drawing` carries a WordprocessingGroup payload. A group this
  * module declines to rasterize has no editable projection either — the shape
  * model holds one shape, not a group — so the caller must preserve it raw.
  */
-declare const isGroupDrawing: (drawing: XmlElement) => boolean;
+export declare const isGroupDrawing: (drawing: XmlElement) => boolean;
 /** Parse a WordprocessingGroup drawing into a safe SVG-backed image preview. */
-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 { groupPreviewTextBoxes, isGroupDrawing, parseGroupDrawing };
+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