@docx-editor.dev/core 2.14.0 → 2.15.0

package/dist/{tree-package-fragment-CWFjgH6a.d.ts → tree-package-fragment-DjkH4ESI.d.ts}

@@ -1,5 +1,6 @@
-import { b as OoxmlPackage, y as SupportedImageMime, O as OoxmlPart, a as OoxmlNode, g as OoxmlElement, E as RevisionAttributionInput, C as ImageDecodePort, F as DrawingTreeDocOp, r as TreeOpRejection, T as TreeDocOp } from './tree-op-types-D6HzlPR4.js';
-import { N as NoteKind, T as TreeModelChange, a as TreeDocumentStore, c as TreeStoryRef, d as TransactionContext, b as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-APgWx6qn.js';
+import { b as OoxmlPackage, y as SupportedImageMime, O as OoxmlPart, C as RevisionAttributionInput, E as ImageDecodePort, F as DrawingTreeDocOp, p as TreeOpRejection, T as TreeDocOp } from './tree-op-types-egdarvH_.js';
+import { c as HeaderFooterKind, H as HeaderFooterVariant } from './hf-references-DTrHkktY.js';
+import { N as NoteKind, T as TreeModelChange, a as TreeDocumentStore, b as TreeStoryRef, c as TransactionContext, d as TransactOptions, S as SelectionMark, e as TreeDocumentCheckpoint } from './tree-store-DKJB0IcA.js';
 
 /** A freshly allocated drawing property id, or the reason one could not be minted. */
 type DrawingPropertyIdResult = {
@@ -63,73 +64,6 @@ interface ExternalImageFetchPort {
     }>>;
 }
 
-/** `w:headerReference w:type` vocabulary (ECMA-376 §17.10.5): default, first page, even pages. */
-type HeaderFooterVariant = 'default' | 'first' | 'even';
-/** Header vs footer region kind for chrome and lifecycle ops. */
-type HeaderFooterKind = 'header' | 'footer';
-/**
- * A section's resolved header and footer parts, by variant.
- *
- * The `even` variant is only honoured when `w:evenAndOddHeaders` is set in settings.xml —
- * without it Word ignores an authored even header, and so does this.
- */
-interface HeaderFooterParts {
-    readonly headers: ReadonlyMap<HeaderFooterVariant, OoxmlPart>;
-    readonly footers: ReadonlyMap<HeaderFooterVariant, OoxmlPart>;
-    /** `w:evenAndOddHeaders` in settings.xml — without it the `even` variant is ignored. */
-    readonly evenAndOddHeaders: boolean;
-    /** Whether this section enables first-page header/footer furniture (`w:titlePg`). */
-    readonly titlePage: boolean;
-}
-/**
- * One resolved furniture slot with enough metadata for "Same as previous" chrome.
- *
- * `inherited: true` means this section has no declared reference for the slot and the
- * part comes from a predecessor. The first section never reports inherited — omitting a
- * ref there is blank furniture, not inheritance from a later section.
- */
-interface HeaderFooterSlotMeta {
-    readonly part: OoxmlPart;
-    readonly partName: string;
-    readonly rId: string;
-    readonly inherited: boolean;
-}
-/** Per-section resolution including declared-vs-inherited metadata. */
-interface HeaderFooterSectionResolution {
-    readonly headers: ReadonlyMap<HeaderFooterVariant, HeaderFooterSlotMeta>;
-    readonly footers: ReadonlyMap<HeaderFooterVariant, HeaderFooterSlotMeta>;
-    readonly evenAndOddHeaders: boolean;
-    readonly titlePage: boolean;
-}
-/**
- * `w:sectPr` nodes in section order, aligned with layout's `enumerateDocumentSections`.
- *
- * `null` means a section with no `w:sectPr` node (Word defaults, inherits HF from previous).
- * Paragraph-level breaks first; the final entry covers remaining blocks (body-level or null).
- */
-declare function collectSectionPropertyNodes(root: OoxmlNode): Array<OoxmlElement | null>;
-/**
- * Resolve header/footer parts for every section with declared-vs-inherited metadata.
- *
- * Index aligns with `enumerateDocumentSections` in the layout package. Existing merged
- * maps stay available via {@link resolveHeaderFooterPartsBySection}.
- */
-declare function resolveHeaderFooterResolutionBySection(pkg: OoxmlPackage): readonly HeaderFooterSectionResolution[];
-/**
- * Resolve header/footer parts for every section, applying OOXML inheritance.
- *
- * Index aligns with `enumerateDocumentSections` in the layout package.
- */
-declare function resolveHeaderFooterPartsBySection(pkg: OoxmlPackage): readonly HeaderFooterParts[];
-/**
- * Resolve the main-document header/footer references to their parts, gated by the
- * settings the section actually declares.
- *
- * Returns the FINAL section's effective parts (after inheritance). Multi-section hosts
- * should prefer `resolveHeaderFooterPartsBySection`.
- */
-declare function resolveHeaderFooterParts(pkg: OoxmlPackage): HeaderFooterParts;
-
 /** Lifecycle impact — furniture always reaches multiple pages; never narrower than flow-structural. */
 type HeaderFooterLifecycleImpact = 'flow-structural' | 'global';
 /**
@@ -729,4 +663,4 @@ type FragmentPasteResult = (Extract<PackageTransactResult, {
  */
 declare function applyFragmentPaste(store: TreePackageStore, scope: StoryScope, input: FragmentPasteInput): FragmentPasteResult;
 
-export { resolveHeaderFooterResolutionBySection as $, type ApplyImagePropertiesInput as A, applyFragmentPaste as B, type CascadeDeletedNoteReferencesOptions as C, DEFAULT_MAX_EDITABLE_STORY_PARTS as D, applyHeaderFooterLifecycleOp as E, type FragmentPasteInput as F, applyNoteLifecycleOp as G, type HeaderFooterVariant as H, type InsertImageInput as I, cascadeDeletedNoteReferences as J, collectNoteReferences as K, collectPackageNoteReferences as L, MAX_FRAGMENT_DECODED_BYTES as M, type NoteDiagnostic as N, collectSectionPropertyNodes as O, type PackageTransactResult as P, createNoteReferenceScanBudget as Q, type ReplaceImageOptions as R, type StoryScope as S, TreePackageStore as T, diagnoseNoteReferences as U, isHeaderFooterLifecycleOp as V, isNoteLifecycleOp as W, normalNoteIds as X, notesPartHasId as Y, resolveHeaderFooterParts as Z, resolveHeaderFooterPartsBySection as _, type StoryTargetRejection as a, resolveNotesPart as a0, withBinaryPart as a1, withEmbeddedImage as a2, withoutUnreferencedImagePart as a3, type HeaderFooterParts as b, type HeaderFooterSectionResolution as c, type ImageIntentResult as d, type FragmentPasteResult as e, type DrawingPropertyIdResult as f, type HeaderFooterKind as g, type HeaderFooterLifecycleImpact as h, type HeaderFooterLifecycleOp as i, type HeaderFooterLifecycleRejection as j, type HeaderFooterLifecycleResult as k, type HeaderFooterSlotMeta as l, MAX_NOTE_REFERENCE_PARTS as m, MAX_NOTE_REFERENCE_SCAN as n, type NoteDiagnosticCode as o, type NoteLifecycleImpact as p, type NoteLifecycleOp as q, type NoteLifecycleOptions as r, type NoteLifecycleRejection as s, type NoteLifecycleResult as t, type NoteReferenceHit as u, type NoteReferenceScanBudget as v, type RemotePackageAttribution as w, type StoryResolveResult as x, type TreePackageStoreOptions as y, allocateDrawingPropertyId as z };
+export { type ApplyImagePropertiesInput as A, collectPackageNoteReferences as B, type CascadeDeletedNoteReferencesOptions as C, DEFAULT_MAX_EDITABLE_STORY_PARTS as D, createNoteReferenceScanBudget as E, type FragmentPasteInput as F, diagnoseNoteReferences as G, type HeaderFooterLifecycleImpact as H, type InsertImageInput as I, isHeaderFooterLifecycleOp as J, isNoteLifecycleOp as K, normalNoteIds as L, MAX_FRAGMENT_DECODED_BYTES as M, type NoteDiagnostic as N, notesPartHasId as O, type PackageTransactResult as P, resolveNotesPart as Q, type ReplaceImageOptions as R, type StoryScope as S, TreePackageStore as T, withBinaryPart as U, withEmbeddedImage as V, withoutUnreferencedImagePart as W, type StoryTargetRejection as a, type ImageIntentResult as b, type FragmentPasteResult as c, type DrawingPropertyIdResult as d, type HeaderFooterLifecycleOp as e, type HeaderFooterLifecycleRejection as f, type HeaderFooterLifecycleResult as g, MAX_NOTE_REFERENCE_PARTS as h, MAX_NOTE_REFERENCE_SCAN as i, type NoteDiagnosticCode as j, type NoteLifecycleImpact as k, type NoteLifecycleOp as l, type NoteLifecycleOptions as m, type NoteLifecycleRejection as n, type NoteLifecycleResult as o, type NoteReferenceHit as p, type NoteReferenceScanBudget as q, type RemotePackageAttribution as r, type StoryResolveResult as s, type TreePackageStoreOptions as t, allocateDrawingPropertyId as u, applyFragmentPaste as v, applyHeaderFooterLifecycleOp as w, applyNoteLifecycleOp as x, cascadeDeletedNoteReferences as y, collectNoteReferences as z };

package/dist/{tree-session-contract-B2HfGt79.d.ts → tree-session-contract-CGOOgPjW.d.ts}

@@ -1,11 +1,13 @@
-import { S as StoryScope, a as StoryTargetRejection, b as HeaderFooterParts, c as HeaderFooterSectionResolution, I as InsertImageInput, d as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput, F as FragmentPasteInput, e as FragmentPasteResult } from './tree-package-fragment-CWFjgH6a.js';
-import { T as TreeDocOp, O as OoxmlPart, a as OoxmlNode, b as OoxmlPackage, g as OoxmlElement, y as SupportedImageMime, C as ImageDecodePort, E as RevisionAttributionInput } from './tree-op-types-D6HzlPR4.js';
-import { D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, a as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind } from './custom-node-writes-DntmaAVW.js';
-import { D as DocumentProperties } from './document-properties-D6Ahr8D6.js';
-import { S as SelectionMark, b as TransactOptions, T as TreeModelChange } from './tree-store-APgWx6qn.js';
-import { a as ReviewItem } from './review-items-CCS1h93f.js';
+import { S as StoryScope, a as StoryTargetRejection, I as InsertImageInput, b as ImageIntentResult, R as ReplaceImageOptions, A as ApplyImagePropertiesInput, F as FragmentPasteInput, c as FragmentPasteResult } from './tree-package-fragment-DjkH4ESI.js';
+import { T as TreeDocOp, O as OoxmlPart, a as OoxmlNode, b as OoxmlPackage, c as OoxmlElement, y as SupportedImageMime, E as ImageDecodePort, C as RevisionAttributionInput } from './tree-op-types-egdarvH_.js';
+import { a as HeaderFooterParts, b as HeaderFooterSectionResolution } from './hf-references-DTrHkktY.js';
+import { D as DocumentTrackingSettings, I as InsertCustomNodeWrite, C as CustomNodeWriteResult, a as CustomNodeSweepOutcome, E as EmbeddedFont, B as BookmarkIndex, L as ListKind } from './custom-node-writes-C9ArIlJh.js';
+import { H as HeadlessDocumentView, D as DocumentProperties } from './headless-document-view-DELC4E5v.js';
+import { S as SelectionMark, d as TransactOptions, T as TreeModelChange } from './tree-store-DKJB0IcA.js';
+import { a as ReviewItem } from './review-items-DYRx187i.js';
 import { Node } from 'prosemirror-model';
 import { CollaborationDocumentPort } from './collaboration/replication.js';
+import { V as ViewScope } from './editor-sRxrFJd8.js';
 
 /**
  * Why an edited projection could not be mapped back into tree ops.
@@ -65,6 +67,18 @@ declare function reconcileDoc(previousDoc: Node, part: OoxmlPart, change: {
     readonly splitJoin: readonly unknown[];
 } | null): Node;
 
+/** The theme's font slots, fully resolved, for resolving `w:rFonts` theme attributes. */
+interface DocumentThemeFonts {
+    /** `a:majorFont` latin typeface — headings. */
+    readonly major: string | null;
+    /** `a:minorFont` latin typeface — body text. */
+    readonly minor: string | null;
+    /** `a:majorFont` east asian typeface (`a:ea`) — headings. */
+    readonly majorEastAsia: string | null;
+    /** `a:minorFont` east asian typeface (`a:ea`) — body text. */
+    readonly minorEastAsia: string | null;
+}
+
 /**
  * How a style LOOKS, for a picker to preview it in its own face — Word shows the gallery
  * that way, and a list of identical rows makes the user apply a style to find out what it
@@ -103,17 +117,6 @@ interface DocumentThemeColorEntry {
     readonly slot: ThemeColorSlot;
     readonly hex: string;
 }
-/** The theme's font slots, for resolving `w:rFonts` theme attributes. */
-interface DocumentThemeFonts {
-    /** `a:majorFont` latin typeface — headings. */
-    readonly major: string | null;
-    /** `a:minorFont` latin typeface — body text. */
-    readonly minor: string | null;
-    /** `a:majorFont` east asian typeface (`a:ea`) — headings. */
-    readonly majorEastAsia: string | null;
-    /** `a:minorFont` east asian typeface (`a:ea`) — body text. */
-    readonly minorEastAsia: string | null;
-}
 
 /** One heading of the outline, in document order. `level` is 0-based (Heading 1 = 0). */
 interface DocumentOutlineEntry {
@@ -131,9 +134,11 @@ interface DocumentSearchOptions {
     readonly wholeWord?: boolean;
     /** Override the default {@link SEARCH_MATCH_LIMIT}. Clamped to it; never raised past it. */
     readonly limit?: number;
+    /** Stories the facade can navigate in its current mode. */
+    readonly stories?: 'all' | 'body';
 }
 /**
- * One occurrence of a query in the body story.
+ * One occurrence of a query in an editable document story.
  *
  * Carries the engine's own address (`blockId` + `start`) and the positional one a find UI
  * needs (`paragraphIndex` / `runIndex` / `runOffset`), both derived from the SAME walk —
@@ -148,6 +153,8 @@ interface DocumentSearchMatch {
     readonly paragraphIndex: number;
     readonly runIndex: number;
     readonly runOffset: number;
+    /** Story containing the match. Omitted for the body. */
+    readonly scope?: ViewScope;
     /** The matched text as it appears in the document, control characters flattened. */
     readonly text: string;
     /** Paragraph text immediately before the match, bounded and flattened. */
@@ -237,7 +244,7 @@ type TreeApplyOptions = Pick<TransactOptions, 'origin' | 'actorId' | 'operationI
  * Holds the whole package, not just the body — headers, footers, notes, comments and styles are
  * all reachable through it, and parts the engine does not model are preserved verbatim.
  */
-interface TreeDocxSessionView {
+interface TreeDocxSessionView extends HeadlessDocumentView {
     /** Whether the body holds at least one editable paragraph. */
     readonly editable: boolean;
     /** Canonical node ids of the body paragraphs, in order. */
@@ -515,11 +522,10 @@ interface TreeDocxSessionView {
      */
     sweepCustomNodePayloads(namespaces: readonly string[]): CustomNodeSweepOutcome;
     /**
-     * Every occurrence of `query` in the BODY story, in document order, addressed in the
-     * same offset vocabulary the tree ops and the surface selection use — so a match can be
-     * handed straight to `setSelection` without re-deriving anything.
+     * Every occurrence of `query` across editable stories, in navigation order. Each match uses
+     * the same offset vocabulary as tree operations and surface selections.
      *
-     * Memoized one deep, keyed on the revision AND the question asked: a find panel asks the
+     * Memoized one deep, keyed on the package revision AND the question asked: a find panel asks the
      * same question on every tick, and a different query replaces the entry rather than
      * growing a cache the session would have to bound.
      */

package/dist/{tree-store-APgWx6qn.d.ts → tree-store-DKJB0IcA.d.ts}

@@ -1,4 +1,4 @@
-import { a as OoxmlNode, j as OoxmlParagraphNode, k as OoxmlNoteNode, l as OoxmlContinuationSeparatorNode, m as OoxmlEndnotesNode, n as OoxmlFootnotesNode, o as OoxmlNoteRefNode, p as OoxmlNoteReferenceNode, q as OoxmlSeparatorNode, I as ImpactClass, O as OoxmlPart, b as OoxmlPackage, T as TreeDocOp, r as TreeOpRejection } from './tree-op-types-D6HzlPR4.js';
+import { a as OoxmlNode, h as OoxmlParagraphNode, i as OoxmlNoteNode, j as OoxmlContinuationSeparatorNode, k as OoxmlEndnotesNode, l as OoxmlFootnotesNode, m as OoxmlNoteRefNode, n as OoxmlNoteReferenceNode, o as OoxmlSeparatorNode, I as ImpactClass, O as OoxmlPart, b as OoxmlPackage, T as TreeDocOp, p as TreeOpRejection } from './tree-op-types-egdarvH_.js';
 
 /** UTF-16 placeholder for one atomic note unit in `paragraphTextOf` / segments. */
 declare const NOTE_ATOM_CHAR = "\uFFFC";
@@ -413,4 +413,4 @@ declare class TreeDocumentStore {
     private publish;
 }
 
-export { type AtomicNoteSpan as A, isNoteReferenceNode as B, isSeparatorNode as C, noteAtomText as D, noteIdOf as E, noteKindOf as F, noteRefKindOf as G, noteReferenceKindOf as H, notesOf as I, parseNoteId as J, parseNoteScopeId as K, MAX_NOTES_PER_PART as M, type NoteKind as N, type SelectionMark as S, type TreeModelChange as T, TreeDocumentStore as a, type TransactOptions as b, type TreeStoryRef as c, type TransactionContext as d, type TreeDocumentCheckpoint as e, NOTE_ATOM_CHAR as f, NOTE_CONTINUATION_SEPARATOR_ID as g, NOTE_ID_MAX as h, NOTE_ID_MIN as i, NOTE_SEPARATOR_ID as j, type NoteType as k, type TreeDocumentStoreOptions as l, type TransactResult as m, noteTypeOf as n, allocateNoteId as o, atomicNoteSpansOf as p, customMarkFollows as q, findNoteById as r, formatNoteScopeId as s, isContinuationSeparatorNode as t, isEndnotesNode as u, isFootnotesNode as v, isNormalNote as w, isNoteAtomNode as x, isNoteNode as y, isNoteRefNode as z };
+export { type AtomicNoteSpan as A, isSeparatorNode as B, noteAtomText as C, noteIdOf as D, noteKindOf as E, noteRefKindOf as F, noteReferenceKindOf as G, noteTypeOf as H, notesOf as I, parseNoteId as J, parseNoteScopeId as K, MAX_NOTES_PER_PART as M, type NoteKind as N, type SelectionMark as S, type TreeModelChange as T, TreeDocumentStore as a, type TreeStoryRef as b, type TransactionContext as c, type TransactOptions as d, type TreeDocumentCheckpoint as e, NOTE_ATOM_CHAR as f, NOTE_CONTINUATION_SEPARATOR_ID as g, NOTE_ID_MAX as h, NOTE_ID_MIN as i, NOTE_SEPARATOR_ID as j, type NoteType as k, type TreeDocumentStoreOptions as l, type TransactResult as m, allocateNoteId as n, atomicNoteSpansOf as o, customMarkFollows as p, findNoteById as q, formatNoteScopeId as r, isContinuationSeparatorNode as s, isEndnotesNode as t, isFootnotesNode as u, isNormalNote as v, isNoteAtomNode as w, isNoteNode as x, isNoteRefNode as y, isNoteReferenceNode as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docx-editor.dev/core",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "Framework-agnostic core for docx-editor.dev: OOXML parse/serialize, the canonical document tree, layout and paint, and the Editor contract the adapters render.",
   "type": "module",
   "engines": {
@@ -67,6 +67,11 @@
       "import": "./dist/output.js",
       "require": "./dist/output.cjs"
     },
+    "./export": {
+      "types": "./dist/export.d.ts",
+      "import": "./dist/export.js",
+      "require": "./dist/export.cjs"
+    },
     "./store": {
       "types": "./dist/store.d.ts",
       "import": "./dist/store.js",
@@ -100,7 +105,7 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@docx-editor.dev/i18n": "^2.14.0",
+    "@docx-editor.dev/i18n": "^2.15.0",
     "bidi-js": "1.0.3",
     "emf-converter": "2.0.2",
     "fast-xml-parser": "^5.10.1",

package/dist/automation.d.cts

@@ -1,82 +0,0 @@
-import { A as AutomationCapabilities, a as AutomationHost } from './protocol-gOY5GA8K.cjs';
-export { b as AUTOMATION_COMMAND_OPERATIONS, c as AUTOMATION_QUERY_OPERATIONS, d as AUTOMATION_SOLITARY_OPERATIONS, e as AutomationAlignment, f as AutomationBatchRequest, g as AutomationBatchResponse, h as AutomationChangeEvent, i as AutomationContentControlLock, j as AutomationContentControlRangeLocation, k as AutomationContentControlScope, l as AutomationContentControlSubtype, m as AutomationContentControlValue, n as AutomationError, o as AutomationErrorCode, p as AutomationFontRead, q as AutomationFontWrite, r as AutomationHandle, s as AutomationHandleRef, t as AutomationObjectKind, u as AutomationOperation, v as AutomationOperationKind, w as AutomationOperationResult, x as AutomationPageOrientation, y as AutomationPageSetupRead, z as AutomationPageSetupWrite, B as AutomationParagraphFormatRead, C as AutomationParagraphFormatWrite, D as AutomationParagraphRef, E as AutomationPoint, F as AutomationSaveResult, G as AutomationSearchOptions, H as AutomationSelectionMode, I as AutomationSpan, J as AutomationSpanRef, K as AutomationTextProjection, L as AutomationUnsubscribe, M as AutomationValue, N as isAutomationCommand, O as isSolitaryAutomationCommand } from './protocol-gOY5GA8K.cjs';
-import { H as HeaderFooterVariant } from './tree-package-fragment-Dhyw7oPm.cjs';
-import { N as NoteKind } from './tree-store-DEEQ9wz_.cjs';
-import { e as OoxmlPackageLimits, f as OoxmlPackageRejection } from './tree-op-types-BUulYD5y.cjs';
-import { CollaborationModuleContribution } from './collaboration.cjs';
-import './contracts/types.cjs';
-import './collaboration/replication.cjs';
-import './failure-BnGjoXf0.cjs';
-
-/** The variants a section can declare furniture for. */
-declare const HEADER_FOOTER_VARIANTS: readonly HeaderFooterVariant[];
-/**
- * Which story an operation acts on: the main body, one header/footer variant of one section, or
- * one note.
- *
- * A header is addressed by section INDEX plus variant rather than by relationship id, because
- * that is how a caller thinks about it and because a section inheriting its predecessor's header
- * has no relationship of its own to name.
- */
-type AutomationStoryId = {
-    readonly kind: 'body';
-} | {
-    readonly kind: 'header' | 'footer';
-    /** Position of the section in the document, from zero. */
-    readonly sectionIndex: number;
-    readonly variant: HeaderFooterVariant;
-} | {
-    readonly kind: 'note';
-    readonly noteKind: NoteKind;
-    readonly noteId: number;
-};
-
-/** What a headless host can do. It paints nothing, so it claims nothing about painting. */
-declare const SERVER_AUTOMATION_CAPABILITIES: AutomationCapabilities;
-/**
- * Why bytes could not be opened as a document: any bounded-reader rejection, plus the package
- * that parsed but carried no main document part.
- */
-type ServerAutomationHostRejection = OoxmlPackageRejection | 'no-main-document-part';
-/**
- * A host over the opened bytes, or a refusal.
- *
- * A result rather than a throw: these bytes are untrusted input, and a malformed upload should
- * be a value the caller inspects rather than an exception from inside a zip decoder.
- */
-type ServerAutomationHostResult = {
-    readonly ok: true;
-    readonly host: AutomationHost;
-} | {
-    readonly ok: false;
-    readonly reason: ServerAutomationHostRejection;
-    readonly detail?: string;
-};
-/**
- * How a headless host opens a document. Every field is optional.
- *
- * @public
- */
-interface ServerAutomationHostOptions {
-    /**
-     * Tighter budgets for the bounded reader — zip ratio, part count, XML depth.
-     *
-     * Exposed because a server opening documents it did not author is exactly where a caller
-     * may want smaller limits than the defaults. Omitted means the engine's own defaults.
-     */
-    readonly limits?: OoxmlPackageLimits;
-    /**
-     * Collaboration replica from the module registry. Absent, this host does
-     * not attach a replica.
-     */
-    readonly collaborationModel?: CollaborationModuleContribution;
-}
-/**
- * Open DOCX bytes into a headless automation host.
- *
- * A typed rejection rather than a throw: every failure here is a property of the FILE, and a
- * caller needs to tell "not a package" from "this package is hostile" from "no body".
- */
-declare function createServerAutomationHost(bytes: Uint8Array, options?: ServerAutomationHostOptions): ServerAutomationHostResult;
-
-export { AutomationCapabilities, AutomationHost, type AutomationStoryId, HEADER_FOOTER_VARIANTS, SERVER_AUTOMATION_CAPABILITIES, type ServerAutomationHostOptions, type ServerAutomationHostRejection, type ServerAutomationHostResult, createServerAutomationHost };

package/dist/binding.d.cts

@@ -1,153 +0,0 @@
-import { Node, Schema } from 'prosemirror-model';
-import { s as OoxmlProperty, f as OoxmlPackageRejection } from './tree-op-types-BUulYD5y.cjs';
-import { T as TreeDocxSessionView, a as TreeApplyResult } from './tree-session-contract-BY9xd7s_.cjs';
-export { D as DocumentStyleEntry, M as MapResult, b as TreeApplyOptions, c as TreeBindingRejection, d as bodyParagraphs, e as docToTreeOps, p as partHasNode, r as reconcileDoc, t as treeToDoc } from './tree-session-contract-BY9xd7s_.cjs';
-import { ReviewModuleContribution } from './contracts/modules.cjs';
-export { S as StoryScope, a as StoryTargetRejection } from './tree-package-fragment-Dhyw7oPm.cjs';
-import { EditorView } from 'prosemirror-view';
-import './contracts/types.cjs';
-import './custom-node-writes-C46r3_5O.cjs';
-import './tree-store-DEEQ9wz_.cjs';
-import './document-properties-D6Ahr8D6.cjs';
-import './review-items-CaAkgi5s.cjs';
-import './collaboration/replication.cjs';
-import './collaboration.cjs';
-import './failure-BnGjoXf0.cjs';
-import './revision-projection-DXbrfNGD.cjs';
-
-/** Attributes carried by a projected paragraph. */
-interface ParagraphAttrs {
-    /** The canonical tree node id this paragraph projects. */
-    readonly nodeId: string | null;
-    /** Accepted `w:pPr` children, as authored. */
-    readonly props: readonly OoxmlProperty[];
-}
-/**
- * The ProseMirror schema the canonical tree projects into.
- *
- * Deliberately minimal. It models only what an editing surface must manipulate directly —
- * paragraphs, text, tabs, breaks, and run properties as marks — because everything it does NOT
- * model stays on the tree and is preserved losslessly there. Widening this schema moves content
- * out of the tree's custody, which is the opposite of what it is for.
- *
- * The node and mark unions are written out rather than inferred from the spec below. Inferred,
- * tsup's dts worker emits their members in an order that varies run to run, so the generated
- * `binding.api.md` differed between builds of identical source and `api:check` failed at random.
- * An explicit annotation pins the emitted order. Adding a node or mark to the spec means adding
- * it here too — the compiler rejects the assignment otherwise.
- */
-declare const treeSchema: Schema<'doc' | 'paragraph' | 'text' | 'tab' | 'hardBreak' | 'pageBreak' | 'unknownInline', 'runProps'>;
-/** The accepted run properties carried by a text node, or an empty list. */
-declare function runPropsOf(node: Node): readonly OoxmlProperty[];
-
-/**
- * Binding-only session methods that exchange ProseMirror projections.
- *
- * Editor surfaces expose {@link TreeDocxSessionView}. Only the binding lane sees this extension.
- */
-interface TreeDocxSession extends TreeDocxSessionView {
-    /** Project the current BODY revision into a ProseMirror doc. */
-    projectDoc(): Node;
-    /** Re-project incrementally from the last committed change, reusing untouched paragraphs. */
-    reconcile(previousDoc: Node): Node;
-    /**
-     * Whether the last commit changed the BLOCK SEQUENCE (a split, join, insert or delete).
-     *
-     * A host needs this to decide whether the view must be re-projected at all. After a pure
-     * text edit, the view already holds what the model holds. Re-projecting wastes work and
-     * races the next keystroke.
-     */
-    lastCommitWasStructural(): boolean;
-    /** Map an edited BODY doc to tree ops and commit them as one transaction. */
-    applyPmDoc(doc: Node): TreeApplyResult;
-}
-
-/**
- * Why bytes could not be opened: any bounded-reader rejection, plus the package that parsed but
- * carried no main document tree.
- */
-type TreeSessionRejection = OoxmlPackageRejection | 'no-main-document-tree';
-/**
- * An open session, or a typed refusal.
- *
- * A result rather than a throw: every failure here is a property of the FILE, and a host needs to
- * tell "this is not a package" from "this package is malicious" from "this document has no body".
- */
-type OpenTreeSessionResult = {
-    readonly ok: true;
-    readonly session: TreeDocxSession;
-} | {
-    readonly ok: false;
-    readonly reason: TreeSessionRejection;
-    readonly detail?: string;
-};
-interface OpenTreeSessionOptions {
-    /**
-     * The review module's derivation hooks, contributed through the editor's
-     * `EditorModule` seam. Absent — the free engine — the session's
-     * `reviewItems()` reports the typed empty queue; parse, preservation, and
-     * `hasReviewContent` are unaffected.
-     */
-    readonly reviewModel?: ReviewModuleContribution;
-}
-/**
- * Open DOCX bytes into a tree-backed session.
- *
- * Returns a typed rejection rather than throwing: every failure here is a property of the FILE,
- * and a host needs to tell "this is not a package" from "this package is malicious" from "this
- * document has no body".
- *
- * The read is BOUNDED — decompression ratio, part count, XML depth and element counts are all
- * capped — because the bytes are untrusted by definition.
- */
-declare function openTreeSession(bytes: Uint8Array, options?: OpenTreeSessionOptions): OpenTreeSessionResult;
-/** The origin a host should use when committing a reconciliation rather than a user edit. */
-declare const PROJECTION_ORIGIN: "dev.docx-editor.core.origin.projection";
-
-/** How a tree surface is mounted. */
-interface TreeSurfaceOptions {
-    /** Called after every commit or refusal, so a host can show revision and rejection state. */
-    readonly onChange?: (state: TreeSurfaceState) => void;
-}
-/**
- * Everything observable about a mounted tree surface.
- *
- * `lastRejection` is part of the state rather than a thrown error because a refused edit is an
- * ordinary outcome here — the binding refuses anything it cannot explain, and the host shows why
- * instead of the edit vanishing.
- */
-interface TreeSurfaceState {
-    readonly revision: number;
-    readonly canUndo: boolean;
-    readonly canRedo: boolean;
-    /** The reason the last transaction was refused, or null when the last one committed. */
-    readonly lastRejection: string | null;
-}
-/**
- * A mounted ProseMirror view bound to a {@link TreeDocxSession}.
- *
- * Every committed transaction becomes tree ops through the binding; a transaction the binding
- * cannot explain is refused and reported through {@link TreeSurfaceState.lastRejection}, leaving
- * the tree untouched.
- */
-interface TreeSurface {
-    readonly view: EditorView;
-    state(): TreeSurfaceState;
-    undo(): void;
-    redo(): void;
-    /** Toggle one accepted run property across the current selection. */
-    toggleRunProperty(localName: string, attributes?: Record<string, string>): void;
-    destroy(): void;
-}
-/**
- * Mount an editable ProseMirror view over a session's body story.
- *
- * The reference binding, not the production surface — `mountPaginatedSurface` is what the shipped
- * editor uses. This one exists to exercise the tree↔ProseMirror contract directly, without
- * pagination or painting in the way.
- *
- * Call {@link TreeSurface.destroy} to release the view.
- */
-declare function mountTreeSurface(mount: HTMLElement, session: TreeDocxSession, options?: TreeSurfaceOptions): TreeSurface;
-
-export { type OpenTreeSessionResult, PROJECTION_ORIGIN, type ParagraphAttrs, TreeApplyResult, type TreeDocxSession, TreeDocxSessionView, type TreeSessionRejection, type TreeSurface, type TreeSurfaceOptions, type TreeSurfaceState, mountTreeSurface, openTreeSession, runPropsOf, treeSchema };