@stll/folio-core 0.62.0 → 0.63.1

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

package/dist/docx/groupDrawingParser.js

@@ -30,7 +30,8 @@ const numericAttr = (element, name) => {
 	return Number.isNaN(parsed) ? 0 : parsed;
 };
 const childTransform = (wsp) => {
-	const xfrm = findChildByLocalName(findChildByLocalName(wsp, "spPr"), "xfrm");
+	const spPr = findChildByLocalName(wsp, "spPr");
+	const xfrm = findChildByLocalName(spPr, "xfrm");
 	const off = findChildByLocalName(xfrm, "off");
 	const ext = findChildByLocalName(xfrm, "ext");
 	return {
@@ -46,7 +47,8 @@ const colorFrom = (parent, fallback) => {
 		if (value && HEX_COLOR.test(value)) return value.toUpperCase();
 	}
 	if (findChildByLocalName(parent, "noFill")) return "none";
-	const srgb = findChildByLocalName(findChildByLocalName(parent, "solidFill"), "srgbClr");
+	const solidFill = findChildByLocalName(parent, "solidFill");
+	const srgb = findChildByLocalName(solidFill, "srgbClr");
 	const referencedSrgb = findChildByLocalName(parent, "srgbClr");
 	const value = getAttribute(srgb ?? referencedSrgb, null, "val");
 	if (value && HEX_COLOR.test(value)) return value.toUpperCase();
@@ -93,7 +95,8 @@ const pathData = (path) => {
 */
 const withChildTransform = (element, piece) => {
 	if (!piece) return piece;
-	const transform = readTransform(findChildByLocalName(findChildByLocalName(element, "spPr"), "xfrm"));
+	const spPr = findChildByLocalName(element, "spPr");
+	const transform = readTransform(findChildByLocalName(spPr, "xfrm"));
 	return wrapTransformed(transform, piece);
 };
 const wrapTransformed = (transform, piece) => {
@@ -165,7 +168,8 @@ const renderPicture = (picture, index, rels, media) => {
 	if (width <= 0 || height <= 0) return "";
 	const blipFill = findChildByLocalName(picture, "blipFill");
 	const blip = findChildByLocalName(blipFill, "blip");
-	const { src } = resolveImageData(getAttribute(blip, "r", "embed") ?? getAttribute(blip, "r", "link") ?? void 0, rels, media);
+	const rId = getAttribute(blip, "r", "embed") ?? getAttribute(blip, "r", "link") ?? void 0;
+	const { src } = resolveImageData(rId, rels, media);
 	if (!src) return "";
 	const sourceRect = findChildByLocalName(blipFill, "srcRect");
 	const left = Math.max(0, numericAttr(sourceRect, "l")) / CROP_SCALE;
@@ -250,7 +254,8 @@ const createSvg = (group, width, height, rels, media, hostedTextBoxes) => {
 	return `<svg xmlns="http://www.w3.org/2000/svg" data-folio-preview="wpGroup" viewBox="0 0 ${width} ${height}" width="${emuToPixels(width)}" height="${emuToPixels(height)}">${transformed}</svg>`;
 };
 const groupElement = (drawing) => {
-	return findChildByLocalName(findAllDeep(drawing, "a", "graphicData").at(0) ?? null, "wgp");
+	const graphicData = findAllDeep(drawing, "a", "graphicData").at(0);
+	return findChildByLocalName(graphicData ?? null, "wgp");
 };
 /**
 * Whether the layout can place the group's text boxes itself. A floating group