@docx-editor.dev/core 2.4.0 → 2.5.0

package/dist/{review-reads-CxgN62yp.d.cts → note-properties-Dhqkro--.d.cts}

@@ -1,70 +1,6 @@
-import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
-import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
-import { R as RevisionAddress } from './tree-op-types-EZXbR8bW.cjs';
-
-/** `w:pos` — where a section's footnotes are laid out. */
-type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
-/** `w:pos` for endnotes — only the two document-level placements are legal. */
-type EndnotePosition = 'sectEnd' | 'docEnd';
-/** `w:numRestart` — when note numbering starts over. `eachPage` needs the reference's page. */
-type NoteNumRestart = 'continuous' | 'eachSect' | 'eachPage';
-/** Authored subset — only keys present in the file appear. */
-interface AuthoredNoteProperties {
-    readonly pos?: string;
-    readonly numFmt?: string;
-    readonly numStart?: number;
-    readonly numRestart?: string;
-}
-/** Fully resolved footnote properties (defaults filled). */
-interface ResolvedFootnoteProperties {
-    readonly pos: FootnotePosition;
-    readonly numFmt: string;
-    readonly numStart: number;
-    readonly numRestart: NoteNumRestart;
-}
-/** Fully resolved endnote properties (defaults filled). */
-interface ResolvedEndnoteProperties {
-    readonly pos: EndnotePosition;
-    readonly numFmt: string;
-    readonly numStart: number;
-    readonly numRestart: NoteNumRestart;
-}
-/** Word's own footnote defaults, applied where a section declares no `w:footnotePr`. */
-declare const DEFAULT_FOOTNOTE_PROPERTIES: ResolvedFootnoteProperties;
-/**
- * Word-compatible defaults. ECMA-376 says omitted endnote `numFmt` is decimal;
- * MS-OE376 / MS-OI29500 document that Word’s default is `lowerRoman` instead.
- * Resolved (not authored) — unedited packages still invent nothing on save.
- */
-declare const DEFAULT_ENDNOTE_PROPERTIES: ResolvedEndnoteProperties;
-/** Parse authored CT_FtnProps / CT_EdnProps without inventing defaults. */
-declare function parseAuthoredNoteProperties(propsNode: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored footnotePr on a sectPr node. */
-declare function authoredFootnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored endnotePr on a sectPr node. */
-declare function authoredEndnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Locate settings.xml via the main document relationship when present. */
-declare function settingsPartOf(pkg: OoxmlPackage): OoxmlPart | null;
-/** Authored document-level footnotePr from settings. */
-declare function authoredDocumentFootnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored document-level endnotePr from settings. */
-declare function authoredDocumentEndnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
-/**
- * Resolve footnote properties: section → document → defaults.
- * Illegal position strings fall through to the next layer / default.
- */
-declare function resolveFootnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedFootnoteProperties;
-/**
- * Resolve endnote properties: section → document → defaults.
- * `pageBottom` is never a legal endnote position — falls back.
- */
-declare function resolveEndnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedEndnoteProperties;
-/** Validate an authored endnote position write — refuse `pageBottom`. */
-declare function isLegalEndnotePosition(pos: string): pos is EndnotePosition;
-/** Validate an authored footnote position write. */
-declare function isLegalFootnotePosition(pos: string): pos is FootnotePosition;
-/** Whether a file-supplied string is a legal `w:numRestart` value. Narrows the type. */
-declare function isLegalNumRestart(value: string): value is NoteNumRestart;
+import { a as OoxmlElement, e as OoxmlPart, O as OoxmlNode } from './ooxml-tree-CG0odFyi.cjs';
+import { R as RevisionAddress } from './tree-op-types-DOYNkKqD.cjs';
+import { O as OoxmlPackage } from './ooxml-package-Cmbe_M04.cjs';
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";
@@ -196,12 +132,34 @@ interface ReviewRevisionItem {
     /** The words a replacement removes. Empty for every other kind. */
     readonly replacedText: string;
     readonly revisionKind: ReviewRevisionKind;
+    /**
+     * WHICH decision a `paragraphMark` records, absent for every other kind.
+     *
+     * `EG_ParaRPrTrackChanges` is `ins? del? moveFrom? moveTo?`, and the four say opposite
+     * things about the same break: one proposes it, another proposes taking it away. Collapsing
+     * them into the single kind lost that, and a card then described a deleted break as an
+     * inserted one — the reverse of what Accept on that card does.
+     */
+    readonly markDirection?: 'insert' | 'delete' | 'moveFrom' | 'moveTo';
     readonly author: string;
     readonly date?: string;
     /** Text the revision covers, for the card summary. Empty for changes with no characters. */
     readonly text: string;
     /** Every site this decision touches, in document order. */
     readonly ranges: readonly ReviewRange[];
+    /**
+     * How deeply this change is NESTED inside other changes, 0 for an unenclosed one.
+     *
+     * Revisions nest for real, and OOXML has no other way to say what happened: `w:ins` wrapping
+     * `w:del` is content one reviewer added and another struck. Both stay pending, because each
+     * author has to be answered separately, so both are cards — over one identical range.
+     *
+     * A range therefore cannot say which change a position is "in", and this is what settles it.
+     * Word treats the innermost change as the operative one: the words are struck on the page
+     * because of the deletion, and accepting the change under them performs that deletion. So the
+     * deepest card wins the caret, and the one enclosing it stays listed and reachable.
+     */
+    readonly nesting: number;
     /**
      * How many leading `ranges` are the STRUCK half of a replacement.
      *
@@ -347,6 +305,8 @@ interface LinkableReviewItem {
     readonly parentRevisionId?: string;
     readonly replyIds?: readonly string[];
     readonly orphaned?: boolean;
+    /** How deeply a revision is nested; absent on the kinds that cannot nest. */
+    readonly nesting?: number;
 }
 /**
  * Attach each comment that answers a tracked change to the change it answers.
@@ -405,4 +365,68 @@ declare function reviewItemRanges(item: ReviewItem): readonly ReviewRange[];
 /** The range an item is anchored at — where its card belongs and how it sorts. */
 declare function firstReviewRange(item: ReviewItem): ReviewRange | null;
 
+/** `w:pos` — where a section's footnotes are laid out. */
+type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
+/** `w:pos` for endnotes — only the two document-level placements are legal. */
+type EndnotePosition = 'sectEnd' | 'docEnd';
+/** `w:numRestart` — when note numbering starts over. `eachPage` needs the reference's page. */
+type NoteNumRestart = 'continuous' | 'eachSect' | 'eachPage';
+/** Authored subset — only keys present in the file appear. */
+interface AuthoredNoteProperties {
+    readonly pos?: string;
+    readonly numFmt?: string;
+    readonly numStart?: number;
+    readonly numRestart?: string;
+}
+/** Fully resolved footnote properties (defaults filled). */
+interface ResolvedFootnoteProperties {
+    readonly pos: FootnotePosition;
+    readonly numFmt: string;
+    readonly numStart: number;
+    readonly numRestart: NoteNumRestart;
+}
+/** Fully resolved endnote properties (defaults filled). */
+interface ResolvedEndnoteProperties {
+    readonly pos: EndnotePosition;
+    readonly numFmt: string;
+    readonly numStart: number;
+    readonly numRestart: NoteNumRestart;
+}
+/** Word's own footnote defaults, applied where a section declares no `w:footnotePr`. */
+declare const DEFAULT_FOOTNOTE_PROPERTIES: ResolvedFootnoteProperties;
+/**
+ * Word-compatible defaults. ECMA-376 says omitted endnote `numFmt` is decimal;
+ * MS-OE376 / MS-OI29500 document that Word’s default is `lowerRoman` instead.
+ * Resolved (not authored) — unedited packages still invent nothing on save.
+ */
+declare const DEFAULT_ENDNOTE_PROPERTIES: ResolvedEndnoteProperties;
+/** Parse authored CT_FtnProps / CT_EdnProps without inventing defaults. */
+declare function parseAuthoredNoteProperties(propsNode: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored footnotePr on a sectPr node. */
+declare function authoredFootnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored endnotePr on a sectPr node. */
+declare function authoredEndnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Locate settings.xml via the main document relationship when present. */
+declare function settingsPartOf(pkg: OoxmlPackage): OoxmlPart | null;
+/** Authored document-level footnotePr from settings. */
+declare function authoredDocumentFootnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored document-level endnotePr from settings. */
+declare function authoredDocumentEndnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
+/**
+ * Resolve footnote properties: section → document → defaults.
+ * Illegal position strings fall through to the next layer / default.
+ */
+declare function resolveFootnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedFootnoteProperties;
+/**
+ * Resolve endnote properties: section → document → defaults.
+ * `pageBottom` is never a legal endnote position — falls back.
+ */
+declare function resolveEndnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedEndnoteProperties;
+/** Validate an authored endnote position write — refuse `pageBottom`. */
+declare function isLegalEndnotePosition(pos: string): pos is EndnotePosition;
+/** Validate an authored footnote position write. */
+declare function isLegalFootnotePosition(pos: string): pos is FootnotePosition;
+/** Whether a file-supplied string is a legal `w:numRestart` value. Narrows the type. */
+declare function isLegalNumRestart(value: string): value is NoteNumRestart;
+
 export { type AuthoredNoteProperties as A, isLegalEndnotePosition as B, type CommentAnchor as C, DEFAULT_ENDNOTE_PROPERTIES as D, type EndnotePosition as E, type FootnotePosition as F, isLegalFootnotePosition as G, isLegalNumRestart as H, linkRevisionReplies as I, parseAuthoredNoteProperties as J, resolveEndnoteProperties as K, type LinkableReviewItem as L, resolveFootnoteProperties as M, type NoteNumRestart as N, reviewItemKey as O, reviewItemRanges as P, revisionItemsOf as Q, type ResolvedFootnoteProperties as R, settingsPartOf as S, threadStateOfPart as T, W15_NAMESPACE_URI as W, type ResolvedEndnoteProperties as a, type CommentPosition as b, type CommentRecord as c, type CommentThreadState as d, DEFAULT_FOOTNOTE_PROPERTIES as e, type ReviewCommentItem as f, type ReviewItem as g, type ReviewModelInput as h, type ReviewPosition as i, type ReviewRange as j, type ReviewRevisionItem as k, type ReviewRevisionKind as l, authoredDocumentEndnoteProperties as m, authoredDocumentFootnoteProperties as n, authoredEndnotePropertiesFromSectPr as o, paragraphOrderOfPart as p, authoredFootnotePropertiesFromSectPr as q, collectReviewItems as r, commentAnchorsOfStory as s, commentBodyText as t, commentInitials as u, commentItemsOf as v, commentsOfPart as w, deepParagraphOrderOfPart as x, firstReviewRange as y, hasAnyComment as z };

package/dist/{ooxml-package-D_CtywTW.d.ts → ooxml-package-BrxTmTsZ.d.ts}

@@ -1,4 +1,44 @@
-import { e as OoxmlPart, X as XmlLimits, n as OoxmlReadRejection } from './ooxml-tree-BU0e3DVi.js';
+import { e as OoxmlPart, X as XmlLimits, n as OoxmlReadRejection } from './ooxml-tree-CG0odFyi.js';
+
+/**
+ * Why a zip was refused at the trust boundary.
+ *
+ * `too-large` and `too-many-entries` are the zip-bomb guards; `bad-name` catches path traversal —
+ * an entry with `..` or a leading `/` is rejected rather than normalized.
+ */
+type ZipRejection = 'too-many-entries' | 'too-large' | 'bad-name' | 'inflate-error';
+/** Archive caps: entry count, total decompressed bytes, and the decompression ratio. */
+interface ZipLimits {
+    readonly maxEntries: number;
+    /** Max total UNCOMPRESSED bytes across the archive. */
+    readonly maxTotalBytes: number;
+    /** Max per-entry uncompressed:compressed ratio (zip-bomb guard). */
+    readonly maxRatio?: number;
+}
+/** The archive caps in force when a host configures none. Conservative and finite. */
+declare const DEFAULT_ZIP_LIMITS: ZipLimits;
+/** The read entries, or the typed refusal. Never throws — the bytes are untrusted. */
+type ZipReadResult = {
+    readonly ok: true;
+    readonly entries: ReadonlyMap<string, Uint8Array>;
+} | {
+    readonly ok: false;
+    readonly reason: ZipRejection;
+    readonly detail?: string;
+};
+/**
+ * Inflate a ZIP archive with bounds + OPC name normalization. Entry name, count,
+ * compression-ratio, and total-uncompressed-size limits are enforced BEFORE each
+ * entry is decompressed (via fflate's pre-inflation filter), so a zip bomb or a
+ * traversal name is rejected without ever being inflated. Keys are canonical part
+ * names.
+ */
+declare function readZip(bytes: Uint8Array, limits?: ZipLimits): ZipReadResult;
+/** Deflate a set of canonical-part-name -> bytes into a ZIP archive. Every part name
+ *  is re-validated through the OPC normalization profile before writing, so a
+ *  traversal/encoded/normalized-alias name from an untrusted serialized model can
+ *  never be smuggled into a ZIP entry (write-side path-traversal guard). */
+declare function writeZip(entries: ReadonlyMap<string, Uint8Array>): Uint8Array;
 
 /**
  * Why a part or relationship name was refused.
@@ -56,91 +96,6 @@ declare function resolveInternalTarget(ownerPartName: string, rawTarget: string)
  */
 declare function validateExternalTarget(raw: string): NameResult;
 
-/** One `<Default>`: a file extension mapped to a content type. */
-interface DefaultRecord {
-    readonly extension: string;
-    readonly contentType: string;
-    readonly order: number;
-}
-/** One `<Override>`: a specific part name mapped to a content type. Beats any Default. */
-interface OverrideRecord {
-    readonly partName: string;
-    readonly contentType: string;
-    readonly order: number;
-}
-/**
- * The authored `[Content_Types].xml` records, in significant order.
- *
- * Retained rather than collapsed into a lookup, because the file's lexical form and ordering are
- * part of what a lossless save re-emits.
- */
-interface ContentTypeRecords {
-    readonly defaults: readonly DefaultRecord[];
-    readonly overrides: readonly OverrideRecord[];
-}
-/**
- * Why content-type records could not be indexed.
- *
- * All fail CLOSED: conflicting Defaults on one extension, duplicate normalized Override names, or
- * invalid MIME syntax are refused rather than resolved by picking one.
- */
-type ContentTypeError = {
-    readonly code: 'invalid-mime';
-    readonly value: string;
-} | {
-    readonly code: 'conflicting-default';
-    readonly extension: string;
-} | {
-    readonly code: 'duplicate-override';
-    readonly partName: string;
-} | {
-    readonly code: 'invalid-override-name';
-    readonly partName: string;
-} | {
-    readonly code: 'too-many-records';
-    readonly limit: number;
-};
-/** Whether a string is syntactically a MIME type. Syntax only — no registry lookup. */
-declare function isValidMime(value: string): boolean;
-/** ASCII-case-insensitive extension key (leading dot removed; ASCII-only fold). */
-declare function extensionKey(extension: string): string;
-/** The resolved lookup: Override by case-folded part name, Default by case-insensitive extension. */
-interface ContentTypeIndex {
-    /** ext key -> single MIME (identical duplicates collapsed). */
-    readonly defaults: ReadonlyMap<string, string>;
-    /** case-folded part name -> MIME. */
-    readonly overrides: ReadonlyMap<string, string>;
-}
-/** The built index, or the conflict that made it impossible. */
-type IndexResult = {
-    readonly ok: true;
-    readonly index: ContentTypeIndex;
-} | {
-    readonly ok: false;
-    readonly error: ContentTypeError;
-};
-/**
- * Build a resolved content-type index, failing closed on conflict/duplicate/MIME
- * errors. `maxRecords` bounds the combined record count (N/N+1 gate).
- */
-declare function buildContentTypeIndex(records: ContentTypeRecords, maxRecords?: number): IndexResult;
-/**
- * A part's content type, or why it has none.
- *
- * An orphan record never determines a part's type — a Default with no matching part is preserved
- * inertly rather than applied.
- */
-type ResolveResult = {
-    readonly ok: true;
-    readonly contentType: string;
-    readonly source: 'override' | 'default';
-} | {
-    readonly ok: false;
-    readonly reason: 'unknown';
-};
-/** Resolve a part's content type: Override wins over Default; else unknown. */
-declare function resolveContentType(index: ContentTypeIndex, partName: string): ResolveResult;
-
 /** OOXML image relationship type for embedded or linked media parts. */
 declare const IMAGE_RELATIONSHIP_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
 /**
@@ -223,45 +178,90 @@ type ImageRelationshipResolution = {
  */
 declare function resolveImageRelationship(records: readonly RelationshipRecord[] | undefined, ownerPart: string, relationshipId: string): ImageRelationshipResolution;
 
+/** One `<Default>`: a file extension mapped to a content type. */
+interface DefaultRecord {
+    readonly extension: string;
+    readonly contentType: string;
+    readonly order: number;
+}
+/** One `<Override>`: a specific part name mapped to a content type. Beats any Default. */
+interface OverrideRecord {
+    readonly partName: string;
+    readonly contentType: string;
+    readonly order: number;
+}
 /**
- * Why a zip was refused at the trust boundary.
+ * The authored `[Content_Types].xml` records, in significant order.
  *
- * `too-large` and `too-many-entries` are the zip-bomb guards; `bad-name` catches path traversal —
- * an entry with `..` or a leading `/` is rejected rather than normalized.
+ * Retained rather than collapsed into a lookup, because the file's lexical form and ordering are
+ * part of what a lossless save re-emits.
  */
-type ZipRejection = 'too-many-entries' | 'too-large' | 'bad-name' | 'inflate-error';
-/** Archive caps: entry count, total decompressed bytes, and the decompression ratio. */
-interface ZipLimits {
-    readonly maxEntries: number;
-    /** Max total UNCOMPRESSED bytes across the archive. */
-    readonly maxTotalBytes: number;
-    /** Max per-entry uncompressed:compressed ratio (zip-bomb guard). */
-    readonly maxRatio?: number;
+interface ContentTypeRecords {
+    readonly defaults: readonly DefaultRecord[];
+    readonly overrides: readonly OverrideRecord[];
 }
-/** The archive caps in force when a host configures none. Conservative and finite. */
-declare const DEFAULT_ZIP_LIMITS: ZipLimits;
-/** The read entries, or the typed refusal. Never throws — the bytes are untrusted. */
-type ZipReadResult = {
+/**
+ * Why content-type records could not be indexed.
+ *
+ * All fail CLOSED: conflicting Defaults on one extension, duplicate normalized Override names, or
+ * invalid MIME syntax are refused rather than resolved by picking one.
+ */
+type ContentTypeError = {
+    readonly code: 'invalid-mime';
+    readonly value: string;
+} | {
+    readonly code: 'conflicting-default';
+    readonly extension: string;
+} | {
+    readonly code: 'duplicate-override';
+    readonly partName: string;
+} | {
+    readonly code: 'invalid-override-name';
+    readonly partName: string;
+} | {
+    readonly code: 'too-many-records';
+    readonly limit: number;
+};
+/** Whether a string is syntactically a MIME type. Syntax only — no registry lookup. */
+declare function isValidMime(value: string): boolean;
+/** ASCII-case-insensitive extension key (leading dot removed; ASCII-only fold). */
+declare function extensionKey(extension: string): string;
+/** The resolved lookup: Override by case-folded part name, Default by case-insensitive extension. */
+interface ContentTypeIndex {
+    /** ext key -> single MIME (identical duplicates collapsed). */
+    readonly defaults: ReadonlyMap<string, string>;
+    /** case-folded part name -> MIME. */
+    readonly overrides: ReadonlyMap<string, string>;
+}
+/** The built index, or the conflict that made it impossible. */
+type IndexResult = {
     readonly ok: true;
-    readonly entries: ReadonlyMap<string, Uint8Array>;
+    readonly index: ContentTypeIndex;
 } | {
     readonly ok: false;
-    readonly reason: ZipRejection;
-    readonly detail?: string;
+    readonly error: ContentTypeError;
 };
 /**
- * Inflate a ZIP archive with bounds + OPC name normalization. Entry name, count,
- * compression-ratio, and total-uncompressed-size limits are enforced BEFORE each
- * entry is decompressed (via fflate's pre-inflation filter), so a zip bomb or a
- * traversal name is rejected without ever being inflated. Keys are canonical part
- * names.
+ * Build a resolved content-type index, failing closed on conflict/duplicate/MIME
+ * errors. `maxRecords` bounds the combined record count (N/N+1 gate).
  */
-declare function readZip(bytes: Uint8Array, limits?: ZipLimits): ZipReadResult;
-/** Deflate a set of canonical-part-name -> bytes into a ZIP archive. Every part name
- *  is re-validated through the OPC normalization profile before writing, so a
- *  traversal/encoded/normalized-alias name from an untrusted serialized model can
- *  never be smuggled into a ZIP entry (write-side path-traversal guard). */
-declare function writeZip(entries: ReadonlyMap<string, Uint8Array>): Uint8Array;
+declare function buildContentTypeIndex(records: ContentTypeRecords, maxRecords?: number): IndexResult;
+/**
+ * A part's content type, or why it has none.
+ *
+ * An orphan record never determines a part's type — a Default with no matching part is preserved
+ * inertly rather than applied.
+ */
+type ResolveResult = {
+    readonly ok: true;
+    readonly contentType: string;
+    readonly source: 'override' | 'default';
+} | {
+    readonly ok: false;
+    readonly reason: 'unknown';
+};
+/** Resolve a part's content type: Override wins over Default; else unknown. */
+declare function resolveContentType(index: ContentTypeIndex, partName: string): ResolveResult;
 
 /** Caps applied while loading a package: zip, XML, part count and relationship count. */
 interface OoxmlPackageLimits {