@stll/folio-core 0.15.0 → 0.15.1

package/dist/content-controls/mutateContentControls.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { ContentControlFilter } from "./findContentControls.js";
-
 //#region src/content-controls/mutateContentControls.d.ts
 type ForceOption = {
   force?: boolean;

package/dist/controller/activeEditorStory.d.ts

@@ -1,5 +1,4 @@
 import { EditorView } from "prosemirror-view";
-
 //#region src/controller/activeEditorStory.d.ts
 type ActiveEditorStoryTarget = {
   type: "note";
@@ -27,10 +26,6 @@ type ActiveEditorStoryCandidates = {
  * adapters from sending formatting, focus, or history commands to a story
  * hidden behind another active editor surface during an async UI transition.
  */
-declare const resolveActiveEditorStory: ({
-  bodyView,
-  headerFooterView,
-  noteView
-}: ActiveEditorStoryCandidates) => ActiveEditorStoryTarget;
+declare const resolveActiveEditorStory: ({ bodyView, headerFooterView, noteView }: ActiveEditorStoryCandidates) => ActiveEditorStoryTarget;
 //#endregion
 export { ActiveEditorStoryCandidates, ActiveEditorStoryTarget, resolveActiveEditorStory };

package/dist/controller/collaborationModules.d.ts

@@ -1,5 +1,4 @@
 import { CollaborationModules } from "./hiddenEditorManager.js";
-
 //#region src/controller/collaborationModules.d.ts
 /** Lazily load and cache the optional collaboration runtime shared by adapters. */
 declare const loadCollaborationModules: () => Promise<CollaborationModules>;

package/dist/controller/contentControlWidgetController.d.ts

@@ -1,7 +1,6 @@
 import { ContentControlWidgetEvent } from "../prosemirror/plugins/contentControlWidgets.js";
 import { Subscribable } from "../managers/Subscribable.js";
 import { EditorView } from "prosemirror-view";
-
 //#region src/controller/contentControlWidgetController.d.ts
 type ContentControlListItem = {
   displayText: string;

package/dist/controller/folioEditor.d.ts

@@ -3,7 +3,6 @@ import { HiddenEditorApi } from "./hiddenEditorApi.js";
 import { FolioEditorEmitter } from "./folioEditorEvents.js";
 import { LayoutRunOptions } from "./layoutScheduler.js";
 import { EditorState } from "prosemirror-state";
-
 //#region src/controller/folioEditor.d.ts
 type FolioEditorDeps = {
   getEditorApi: () => HiddenEditorApi | null;
@@ -12,7 +11,8 @@ type FolioEditorDeps = {
   emitter: FolioEditorEmitter;
 };
 type FolioEditor = HiddenEditorApi & {
-  getLayout: () => Layout | null; /** Re-run layout for the current editor state (no-op if there is no view). */
+  getLayout: () => Layout | null;
+  /** Re-run layout for the current editor state (no-op if there is no view). */
   relayout: () => void;
   on: FolioEditorEmitter["on"];
 };

package/dist/controller/folioEditorEvents.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { Layout } from "../layout-engine/types.js";
-
 //#region src/controller/folioEditorEvents.d.ts
 type FolioSelectionEvent = {
   from: number;
@@ -14,8 +13,11 @@ type FolioEditorEventMap = {
 type FolioEditorEventName = keyof FolioEditorEventMap;
 type FolioEditorEventListener<K extends FolioEditorEventName> = (payload: FolioEditorEventMap[K]) => void;
 type FolioEditorEmitter = {
-  /** Subscribe to an event. Returns an unsubscribe function. */on: <K extends FolioEditorEventName>(event: K, listener: FolioEditorEventListener<K>) => () => void; /** Emit an event to all current listeners. */
-  emit: <K extends FolioEditorEventName>(event: K, payload: FolioEditorEventMap[K]) => void; /** Drop all listeners (call on controller teardown). */
+  /** Subscribe to an event. Returns an unsubscribe function. */
+  on: <K extends FolioEditorEventName>(event: K, listener: FolioEditorEventListener<K>) => () => void;
+  /** Emit an event to all current listeners. */
+  emit: <K extends FolioEditorEventName>(event: K, payload: FolioEditorEventMap[K]) => void;
+  /** Drop all listeners (call on controller teardown). */
   clear: () => void;
 };
 declare const createFolioEditorEmitter: () => FolioEditorEmitter;

package/dist/controller/fontReadiness.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { EditorState } from "prosemirror-state";
-
 //#region src/controller/fontReadiness.d.ts
 declare function getDocumentFontSet(): FontFaceSet | null;
 declare function documentFontsAreLoaded(): boolean;

package/dist/controller/headerFooterEditorManager.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { EditorView } from "prosemirror-view";
-
 //#region src/controller/headerFooterEditorManager.d.ts
 type HeaderFooterPartKind = "header" | "footer";
 type HeaderFooterPartKey = {
@@ -28,10 +27,7 @@ type HeaderFooterEditorManager = {
   snapshotDocument: (document: document_d_exports.Document) => document_d_exports.Document;
   sync: () => void;
 };
-declare const enumerateHeaderFooterParts: ({
-  headers,
-  footers
-}: {
+declare const enumerateHeaderFooterParts: ({ headers, footers }: {
   headers: Map<string, document_d_exports.HeaderFooter> | undefined;
   footers: Map<string, document_d_exports.HeaderFooter> | undefined;
 }) => HeaderFooterPartKey[];

package/dist/controller/hiddenEditorApi.d.ts

@@ -1,26 +1,43 @@
 import { document_d_exports } from "../types/document.js";
 import { Command, EditorState, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
-
 //#region src/controller/hiddenEditorApi.d.ts
 type HiddenEditorApi = {
-  /** Request the off-screen EditorView (idempotent; creates it when possible). */ensureView: () => void; /** Whether view creation has been requested. */
-  isViewRequested: () => boolean; /** Get the ProseMirror EditorState */
-  getState: () => EditorState | null; /** Get the ProseMirror EditorView */
-  getView: () => EditorView | null; /** Get the current Document from PM state */
-  getDocument: () => document_d_exports.Document | null; /** Focus the hidden editor */
-  focus: () => void; /** Blur the hidden editor */
-  blur: () => void; /** Check if focused */
-  isFocused: () => boolean; /** Dispatch a transaction */
-  dispatch: (tr: Transaction) => void; /** Execute a ProseMirror command */
-  executeCommand: (command: Command) => boolean; /** Undo */
-  undo: () => boolean; /** Redo */
-  redo: () => boolean; /** Check if undo is available */
-  canUndo: () => boolean; /** Check if redo is available */
-  canRedo: () => boolean; /** Set selection by PM position */
-  setSelection: (anchor: number, head?: number) => void; /** Set node selection at a PM position (for images, etc.) */
-  setNodeSelection: (pos: number) => void; /** Set cell selection between two positions inside table cells */
-  setCellSelection: (anchorCellPos: number, headCellPos: number) => void; /** Scroll the PM view to selection (no-op since hidden) */
+  /** Request the off-screen EditorView (idempotent; creates it when possible). */
+  ensureView: () => void;
+  /** Whether view creation has been requested. */
+  isViewRequested: () => boolean;
+  /** Get the ProseMirror EditorState */
+  getState: () => EditorState | null;
+  /** Get the ProseMirror EditorView */
+  getView: () => EditorView | null;
+  /** Get the current Document from PM state */
+  getDocument: () => document_d_exports.Document | null;
+  /** Focus the hidden editor */
+  focus: () => void;
+  /** Blur the hidden editor */
+  blur: () => void;
+  /** Check if focused */
+  isFocused: () => boolean;
+  /** Dispatch a transaction */
+  dispatch: (tr: Transaction) => void;
+  /** Execute a ProseMirror command */
+  executeCommand: (command: Command) => boolean;
+  /** Undo */
+  undo: () => boolean;
+  /** Redo */
+  redo: () => boolean;
+  /** Check if undo is available */
+  canUndo: () => boolean;
+  /** Check if redo is available */
+  canRedo: () => boolean;
+  /** Set selection by PM position */
+  setSelection: (anchor: number, head?: number) => void;
+  /** Set node selection at a PM position (for images, etc.) */
+  setNodeSelection: (pos: number) => void;
+  /** Set cell selection between two positions inside table cells */
+  setCellSelection: (anchorCellPos: number, headCellPos: number) => void;
+  /** Scroll the PM view to selection (no-op since hidden) */
   scrollToSelection: () => void;
 };
 type HiddenEditorApiDeps = {

package/dist/controller/hiddenEditorManager.d.ts

@@ -7,7 +7,6 @@ import { EditorView } from "prosemirror-view";
 import * as YProseMirror from "y-prosemirror";
 import * as Yjs from "yjs";
 import { XmlFragment } from "yjs";
-
 //#region src/controller/hiddenEditorManager.d.ts
 type YProseMirrorModule = typeof YProseMirror;
 type YjsModule = typeof Yjs;
@@ -67,7 +66,8 @@ type HiddenEditorManagerDeps = {
    * distinct key per loaded file. Authoritative when present; a metadata
    * signature is used as a fallback when undefined.
    */
-  getDocumentKey: () => string | undefined; /** Document context for the API's `getDocument` (PM state -> Document). */
+  getDocumentKey: () => string | undefined;
+  /** Document context for the API's `getDocument` (PM state -> Document). */
   getDocumentContext: () => document_d_exports.Document | null;
   onTransaction: (transaction: Transaction, newState: EditorState) => void;
   onSelectionChange: (state: EditorState) => void;
@@ -89,7 +89,9 @@ declare const createHiddenEditorClipboardHandlers: (deps: Pick<HiddenEditorManag
   paste: (_view: unknown, event: PreventableDomEvent) => boolean;
 };
 type HiddenEditorManager = {
-  /** Request the view (sets the requested flag, then attempts creation). */ensureView: () => void; /** Re-attempt a previously-requested-but-deferred creation (no-op otherwise). */
+  /** Request the view (sets the requested flag, then attempts creation). */
+  ensureView: () => void;
+  /** Re-attempt a previously-requested-but-deferred creation (no-op otherwise). */
   retryViewCreation: () => void;
   isViewRequested: () => boolean;
   destroyView: () => void;

package/dist/controller/latestRequestGate.d.ts

@@ -5,7 +5,9 @@
  * cannot accidentally make an older request current again.
  */
 type LatestRequestGate = {
-  /** Start a request and return a guard that remains true while it is latest. */begin: () => () => boolean; /** Supersede the current request without starting another one. */
+  /** Start a request and return a guard that remains true while it is latest. */
+  begin: () => () => boolean;
+  /** Supersede the current request without starting another one. */
   invalidate: () => void;
 };
 declare const createLatestRequestGate: () => LatestRequestGate;

package/dist/controller/layoutPipeline.d.ts

@@ -4,12 +4,12 @@ import { ColumnLayout, FlowBlock, FootnoteContent, HeaderFooterContent, Layout,
 import { LayoutRunReason } from "../layout-engine/layoutInstrumentation.js";
 import { DirtyRange } from "../paged-layout/incrementalMeasure.js";
 import { ConvertHeaderFooterOptions, HeaderFooterMetrics } from "../layout-bridge/convert/headerFooterLayout.js";
+import "../layout-engine/index.js";
 import { FootnoteRenderItem } from "../layout-painter/renderPage.js";
 import { BlockLookup, LayoutPainter } from "../layout-painter/index.js";
 import { LayoutSelectionGate } from "../paged-layout/LayoutSelectionGate.js";
 import { LayoutSession } from "./layoutSession.js";
 import { EditorState } from "prosemirror-state";
-
 //#region src/controller/layoutPipeline.d.ts
 type LayoutRunOptions = {
   dirtyRange?: DirtyRange;

package/dist/controller/layoutScheduler.d.ts

@@ -1,6 +1,5 @@
 import { LayoutRunReason } from "../layout-engine/layoutInstrumentation.js";
 import { DirtyRange } from "../paged-layout/incrementalMeasure.js";
-
 //#region src/controller/layoutScheduler.d.ts
 type LayoutRunOptions = {
   dirtyRange?: DirtyRange;
@@ -17,9 +16,12 @@ type SchedulerClock = {
 };
 declare const browserClock: SchedulerClock;
 type LayoutSchedulerConfig<TState> = {
-  runLayout: RunLayout<TState>; /** Quiet-window debounce before an interactive layout pass. */
-  debounceMs: number; /** Run the first edit after a max-delay-sized idle period on the next frame. */
-  leadingFrame?: boolean; /** Hard cap on latency from the first edit in a burst. */
+  runLayout: RunLayout<TState>;
+  /** Quiet-window debounce before an interactive layout pass. */
+  debounceMs: number;
+  /** Run the first edit after a max-delay-sized idle period on the next frame. */
+  leadingFrame?: boolean;
+  /** Hard cap on latency from the first edit in a burst. */
   maxDelayMs: number;
   /**
    * Timing source. Pass `browserClock` in the browser; a host injects its own
@@ -34,7 +36,8 @@ type LayoutScheduler<TState> = {
    * the window replace the pending state and merge dirty ranges, so a typing
    * burst paints once while still honoring the max-latency cap.
    */
-  schedule: (state: TState, dirtyRange: DirtyRange | null) => void; /** Cancel any pending timer/frame. Call on teardown. */
+  schedule: (state: TState, dirtyRange: DirtyRange | null) => void;
+  /** Cancel any pending timer/frame. Call on teardown. */
   dispose: () => void;
 };
 declare const createLayoutScheduler: <TState>(config: LayoutSchedulerConfig<TState>) => LayoutScheduler<TState>;

package/dist/controller/layoutSession.d.ts

@@ -1,7 +1,6 @@
 import { TemplatePreviewEntry, TemplatePreviewValues } from "../prosemirror/plugins/templatePreviewValues.js";
 import { FlowBlock, Measure } from "../layout-engine/types.js";
 import { EditorState } from "prosemirror-state";
-
 //#region src/controller/layoutSession.d.ts
 type LayoutArtifacts = {
   blocks: FlowBlock[];

package/dist/controller/noteEditorManager.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { Plugin } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
-
 //#region src/controller/noteEditorManager.d.ts
 type NoteStoryKind = "footnote" | "endnote";
 type NoteStoryKey = {

package/dist/document-operations.d.ts

@@ -1,6 +1,5 @@
 import { FolioAIEditAppliedOperation, FolioAIEditApplyMode, FolioAIEditOperation, FolioAIEditPrecondition, FolioAIEditSkippedOperation, FolioAIEditSnapshot, FolioAITextRangeHandle } from "./ai-edits/types.js";
 import { FolioAIEditView } from "./ai-edits/apply.js";
-
 //#region src/document-operations.d.ts
 declare const FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION: 1;
 declare const FOLIO_DOCUMENT_OPERATION_TYPES: readonly ["replaceInBlock", "replaceRange", "commentOnRange", "formatRange", "insertAfterBlock", "insertBeforeBlock", "replaceBlock", "deleteBlock", "commentOnBlock", "insertSignatureTable", "insertTableRow", "deleteTableRow", "insertTableColumn", "deleteTableColumn", "mergeTableCells", "splitTableCell"];
@@ -158,8 +157,10 @@ type FolioDocumentOperationResult = {
   status: FolioDocumentOperationStatus;
   applied: FolioAIEditAppliedOperation[];
   skipped: FolioAIEditSkippedOperation[];
-  issues: FolioDocumentOperationIssue[]; /** Successful effects in input-operation order; skipped operations are omitted. */
-  receipts: FolioDocumentOperationReceipt[]; /** Present when the execution surface can undo this committed batch. */
+  issues: FolioDocumentOperationIssue[];
+  /** Successful effects in input-operation order; skipped operations are omitted. */
+  receipts: FolioDocumentOperationReceipt[];
+  /** Present when the execution surface can undo this committed batch. */
   undoHandle: FolioDocumentOperationUndoHandle | null;
 };
 declare const getFolioDocumentOperationIssues: (operations: readonly FolioDocumentOperation[], skipped: readonly FolioAIEditSkippedOperation[]) => FolioDocumentOperationIssue[];
@@ -174,14 +175,6 @@ type ApplyFolioDocumentOperationsOptions = {
   createCommentId?: (text: string) => number;
   createUndoHandle?: () => FolioDocumentOperationUndoHandle;
 };
-declare const applyFolioDocumentOperations: ({
-  view,
-  snapshot,
-  batch,
-  story,
-  author,
-  createCommentId,
-  createUndoHandle
-}: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
+declare const applyFolioDocumentOperations: ({ view, snapshot, batch, story, author, createCommentId, createUndoHandle }: ApplyFolioDocumentOperationsOptions) => FolioDocumentOperationResult;
 //#endregion
 export { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MODES, FOLIO_DOCUMENT_OPERATION_CONTRACT_VERSION, FOLIO_DOCUMENT_OPERATION_MODES, FOLIO_DOCUMENT_OPERATION_MODES_BY_TYPE, FOLIO_DOCUMENT_OPERATION_PRECONDITIONS, FOLIO_DOCUMENT_OPERATION_STORIES, FOLIO_DOCUMENT_OPERATION_TYPES, FolioDocumentOperation, FolioDocumentOperationAffectedTarget, FolioDocumentOperationBatch, FolioDocumentOperationCapabilities, FolioDocumentOperationIssue, FolioDocumentOperationMode, FolioDocumentOperationPrecondition, FolioDocumentOperationReceipt, FolioDocumentOperationRecovery, FolioDocumentOperationResult, FolioDocumentOperationStatus, FolioDocumentOperationStory, FolioDocumentOperationType, FolioDocumentOperationUndoFailureReason, FolioDocumentOperationUndoHandle, FolioDocumentOperationUndoResult, InvalidFolioDocumentOperationBatchError, UnsupportedFolioDocumentOperationVersionError, applyFolioDocumentOperations, assertSupportedFolioDocumentOperationVersion, getFolioDocumentOperationCapabilities, getFolioDocumentOperationIssues, getFolioDocumentOperationReceipts, isFolioDocumentOperationModeSupported, isSupportedFolioDocumentOperationVersion, parseFolioDocumentOperationBatch };

package/dist/document-stories.d.ts

@@ -1,5 +1,4 @@
 import { FolioDocumentStoryHandle } from "./ai-edits/headless.js";
-
 //#region src/document-stories.d.ts
 type FolioDocumentStoryPair = {
   baseStory: FolioDocumentStoryHandle | null;

package/dist/docx/blockContentParser.d.ts

@@ -2,7 +2,6 @@ import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
 import { StyleMap } from "./styleParser.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/blockContentParser.d.ts
 type ParseBlockContentOptions = {
   inHeaderFooter?: boolean;

package/dist/docx/blockContentParser.js

@@ -181,6 +181,7 @@ const parseBlockContentWithState = (parent, styles, theme, numbering, rels, medi
 		}
 		if (localName === "tbl") {
 			const table = parseTable(child, styles, theme, numbering, rels, media, state.options);
+			if (!table) continue;
 			if (prependBookmarkMarkersToFirstParagraphInBlocks([table], pendingBookmarkMarkers)) pendingBookmarkMarkers.length = 0;
 			content.push(table);
 			continue;

package/dist/docx/bookmarkParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/bookmarkParser.d.ts
 /**
  * Parse a bookmark start element (w:bookmarkStart)
@@ -28,8 +27,11 @@ declare function parseBookmarkEnd(node: XmlElement): document_d_exports.Bookmark
  * Bookmark map for quick lookup by ID or name
  */
 type BookmarkMap = {
-  /** Lookup bookmark start by ID */byId: Map<number, document_d_exports.BookmarkStart>; /** Lookup bookmark start by name (for hyperlink resolution) */
-  byName: Map<string, document_d_exports.BookmarkStart>; /** All bookmark starts in document order */
+  /** Lookup bookmark start by ID */
+  byId: Map<number, document_d_exports.BookmarkStart>;
+  /** Lookup bookmark start by name (for hyperlink resolution) */
+  byName: Map<string, document_d_exports.BookmarkStart>;
+  /** All bookmark starts in document order */
   bookmarks: document_d_exports.BookmarkStart[];
 };
 /**

package/dist/docx/bookmarkPlacement.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/bookmarkPlacement.d.ts
 type BookmarkMarker = document_d_exports.BookmarkStart | document_d_exports.BookmarkEnd;
 declare const appendBookmarkMarkerToLastParagraphInBlocks: (blocks: readonly document_d_exports.BlockContent[], marker: BookmarkMarker) => boolean;

package/dist/docx/commentParser.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { StyleMap } from "./styleParser.js";
-
 //#region src/docx/commentParser.d.ts
 type CommentExtendedInfo = {
   parentParaId?: string;

package/dist/docx/commentRangeIntegrity.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/commentRangeIntegrity.d.ts
 declare const withoutOrphanCommentRanges: (doc: document_d_exports.Document) => document_d_exports.Document;
 //#endregion

package/dist/docx/commentReferenceNormalization.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/commentReferenceNormalization.d.ts
 type NormalizeCommentReferencesInput = {
   documentBody: document_d_exports.DocumentBody;
@@ -13,13 +12,6 @@ type NormalizeCommentReferencesResult = {
   removedDanglingReferences: number;
   reanchoredUnbalancedRanges: number;
 };
-declare const normalizeCommentReferences: ({
-  documentBody,
-  comments,
-  headers,
-  footers,
-  footnotes,
-  endnotes
-}: NormalizeCommentReferencesInput) => NormalizeCommentReferencesResult;
+declare const normalizeCommentReferences: ({ documentBody, comments, headers, footers, footnotes, endnotes }: NormalizeCommentReferencesInput) => NormalizeCommentReferencesResult;
 //#endregion
 export { normalizeCommentReferences };

package/dist/docx/commentReplyMarkers.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/commentReplyMarkers.d.ts
 /**
  * Synthesize reply range markers into a document model in place, so every

package/dist/docx/compatibility.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/compatibility.d.ts
 type DocxCompatibilityReason = "opaqueDrawing";
 type FolioDocxCompatibilityHost = "browser" | "server" | "unknown";

package/dist/docx/conformance.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/conformance.d.ts
 declare const detectDocxConformanceClass: (documentXml: string | null) => document_d_exports.DocxConformanceClass;
 //#endregion

package/dist/docx/corePropertiesParser.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/docx/corePropertiesParser.d.ts
 type DocumentProperties = NonNullable<document_d_exports.DocxPackage["properties"]>;
 /** Parse recognized package metadata from `docProps/core.xml`. */

package/dist/docx/documentParser.d.ts

@@ -1,7 +1,6 @@
 import { document_d_exports } from "../types/document.js";
 import { NumberingMap } from "./numberingParser.js";
 import { StyleMap } from "./styleParser.js";
-
 //#region src/docx/documentParser.d.ts
 /**
  * Extract template variables from text

package/dist/docx/documentParser.js

@@ -2,6 +2,7 @@ import { collectXmlnsDeclarations, findChild, parseXml } from "./xmlParser.js";
 import { getDefaultSectionProperties, parseSectionProperties } from "./sectionParser.js";
 import { getParagraphText } from "./paragraphParser.js";
 import { parseBlockContent } from "./blockContentParser.js";
+import { parseStreamingXml } from "./streamingXmlParser.js";
 //#region src/docx/documentParser.ts
 /**
 * Regular expression to match template variables {{...}}
@@ -98,7 +99,8 @@ function buildSections(content, finalSectPr) {
 function parseDocumentBody(xml, styles = null, theme = null, numbering = null, rels = null, media = null) {
 	const result = { content: [] };
 	if (!xml) return result;
-	const documentEl = (parseXml(xml).elements ?? []).find((el) => el.type === "element" && (el.name === "w:document" || el.name?.endsWith(":document")));
+	const streamed = parseStreamingXml(xml);
+	const documentEl = ((streamed.status === "parsed" ? streamed.value : parseXml(xml)).elements ?? []).find((el) => el.type === "element" && (el.name === "w:document" || el.name?.endsWith(":document")));
 	if (!documentEl) return result;
 	const bodyEl = findChild(documentEl, "w", "body");
 	if (!bodyEl) return result;

package/dist/docx/drawingUtils.d.ts

@@ -1,7 +1,28 @@
 import { document_d_exports } from "../types/document.js";
 import { XmlElement } from "./xmlParser.js";
-
 //#region src/docx/drawingUtils.d.ts
+/**
+ * Map normalized theme color slots back to DrawingML scheme color names.
+ * DrawingML uses bg1/bg2/tx1/tx2 where the document model uses descriptive names.
+ */
+declare const THEME_COLOR_TO_DRAWING_SCHEME: {
+  readonly dk1: "dk1";
+  readonly lt1: "lt1";
+  readonly dk2: "dk2";
+  readonly lt2: "lt2";
+  readonly accent1: "accent1";
+  readonly accent2: "accent2";
+  readonly accent3: "accent3";
+  readonly accent4: "accent4";
+  readonly accent5: "accent5";
+  readonly accent6: "accent6";
+  readonly hlink: "hlink";
+  readonly folHlink: "folHlink";
+  readonly background1: "bg1";
+  readonly text1: "tx1";
+  readonly background2: "bg2";
+  readonly text2: "tx2";
+};
 /**
  * Parse a color value from a DrawingML element.
  * Handles: a:srgbClr, a:schemeClr, a:sysClr, a:prstClr
@@ -53,4 +74,4 @@ declare function parseAnchorWrap(anchor: XmlElement): document_d_exports.ImageWr
  */
 declare function resolveColorValueToHex(color: document_d_exports.ColorValue | undefined): string | undefined;
 //#endregion
-export { WRAP_ELEMENT_NAMES, parseAnchorPosition, parseAnchorWrap, parseColorElement, parseFill, parseOutline, parsePositionH, parsePositionV, parseWrapElement, resolveColorValueToHex };
+export { THEME_COLOR_TO_DRAWING_SCHEME, WRAP_ELEMENT_NAMES, parseAnchorPosition, parseAnchorWrap, parseColorElement, parseFill, parseOutline, parsePositionH, parsePositionV, parseWrapElement, resolveColorValueToHex };

package/dist/docx/drawingUtils.js

@@ -24,6 +24,28 @@ const SCHEME_TO_THEME_COLOR = {
 	folHlink: "folHlink"
 };
 /**
+* Map normalized theme color slots back to DrawingML scheme color names.
+* DrawingML uses bg1/bg2/tx1/tx2 where the document model uses descriptive names.
+*/
+const THEME_COLOR_TO_DRAWING_SCHEME = {
+	dk1: "dk1",
+	lt1: "lt1",
+	dk2: "dk2",
+	lt2: "lt2",
+	accent1: "accent1",
+	accent2: "accent2",
+	accent3: "accent3",
+	accent4: "accent4",
+	accent5: "accent5",
+	accent6: "accent6",
+	hlink: "hlink",
+	folHlink: "folHlink",
+	background1: "bg1",
+	text1: "tx1",
+	background2: "bg2",
+	text2: "tx2"
+};
+/**
 * sRGB hex per OOXML (ST_HexColorRGB): exactly six hex digits, case-insensitive.
 * Anything else is rejected so untrusted DOCX input cannot smuggle markup through
 * downstream renderers that interpolate the value into HTML/SVG.
@@ -302,4 +324,4 @@ function resolveColorValueToHex(color) {
 	if (color.themeColor) return `#${DEFAULT_THEME_COLOR_HEX[color.themeColor] ?? "000000"}`;
 }
 //#endregion
-export { WRAP_ELEMENT_NAMES, parseAnchorPosition, parseAnchorWrap, parseColorElement, parseFill, parseOutline, parsePositionH, parsePositionV, parseWrapElement, resolveColorValueToHex };
+export { THEME_COLOR_TO_DRAWING_SCHEME, WRAP_ELEMENT_NAMES, parseAnchorPosition, parseAnchorWrap, parseColorElement, parseFill, parseOutline, parsePositionH, parsePositionV, parseWrapElement, resolveColorValueToHex };

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

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

package/dist/docx/encryption/cryptoBytes.js

@@ -34,7 +34,10 @@ const bytesEqual = (left, right) => {
 	for (let i = 0; i < left.length; i++) mismatch |= left[i] ^ right[i];
 	return mismatch === 0;
 };
-const toArrayBuffer = (bytes) => bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+const toArrayBuffer = (bytes) => {
+	if (bytes.buffer instanceof ArrayBuffer && bytes.byteOffset === 0 && bytes.byteLength === bytes.buffer.byteLength) return bytes.buffer;
+	return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+};
 const decodeBase64 = (encoded) => {
 	if (typeof atob === "function") {
 		const binary = atob(encoded);

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

@@ -7,10 +7,13 @@
  * @see https://learn.microsoft.com/en-us/openspecs/office_file_formats/ms-offcrypto/
  */
 type DecryptDocxOptions = {
-  /** Password for Agile-encrypted .docx files (Office 2010+). */password?: string | undefined;
+  /** Password for Agile-encrypted .docx files (Office 2010+). */
+  password?: string | undefined;
 };
 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. */
+  /** Plaintext OOXML ZIP bytes, or the original buffer when unencrypted. */
+  data: ArrayBuffer;
+  /** True when the input was an encrypted CFB container and decryption ran. */
   wasEncrypted: boolean;
 };
 /**

package/dist/docx/ensureParaIds.d.ts

@@ -7,9 +7,13 @@ declare const EnsureParaIdsError_base: import("better-result").TaggedErrorClass<
 declare class EnsureParaIdsError extends EnsureParaIdsError_base {}
 /** Counts and normalized bytes returned by {@link ensureParaIds}. */
 type EnsureParaIdsResult = {
-  /** The normalized `.docx`; the input bytes verbatim when `alreadyComplete`. */docx: Uint8Array; /** Paragraphs that received a paraId (missing or all-zero before). */
-  assigned: number; /** Duplicate paraIds reassigned (the first occurrence keeps the id). */
-  deduplicated: number; /** True when the input already had full, unique coverage. */
+  /** The normalized `.docx`; the input bytes verbatim when `alreadyComplete`. */
+  docx: Uint8Array;
+  /** Paragraphs that received a paraId (missing or all-zero before). */
+  assigned: number;
+  /** Duplicate paraIds reassigned (the first occurrence keeps the id). */
+  deduplicated: number;
+  /** True when the input already had full, unique coverage. */
   alreadyComplete: boolean;
 };
 /** Controls mutation of package metadata that has security implications. */