@docx-editor.dev/core 0.0.1 → 2.0.1

package/dist/layout.js

@@ -0,0 +1 @@
+export{Gb as AUTO_PREFERRED_WIDTH,Ib as CELL_PAD,$ as COMPOUND_BORDER_MIN_GAP_PT,_ as COMPOUND_BORDER_MIN_STROKE_PT,fd as DEFAULT_CANVAS_FONT_STACK,Kb as DEFAULT_CELL_MARGINS,Q as DEFAULT_PAGE_GEOMETRY,Ya as DEFAULT_REVISION_DISPLAY_MODE,bb as DEFAULT_RUN_STYLE,xc as DEFAULT_SECTION_PROPERTIES,Ba as DEFAULT_TAB_INTERVAL_PT,Aa as DEFAULT_TAB_INTERVAL_TWIPS,_b as DEFAULT_VERTICAL_WEIGHT,Rb as EMPTY_NUMBERING_INDEX,Da as EMPTY_TAB_STOPS,p as GRAPHEME_SEGMENTER_LOCALE,g as HARFBUZZ_SHAPING_LIBRARY,j as HarfBuzzShapingError,ea as MAX_BORDER_SPACE_PT,da as MAX_BORDER_WIDTH_PT,wc as MAX_DOCUMENT_SECTIONS,Wc as MAX_EACH_PAGE_MARK_CANDIDATES,Ob as MAX_LVL_OVERRIDES,Ma as MAX_LVL_TEXT_LENGTH,La as MAX_MARKER_TEXT_LENGTH,Ic as MAX_NOTES_LAID_OUT,Jc as MAX_NOTE_FRAGMENTS,Vc as MAX_NOTE_OVERFLOW_PAGES,Uc as MAX_NOTE_REFLOW_ATTEMPTS,Nb as MAX_NUMBERING_DEFINITIONS,ca as MAX_PARAGRAPH_SPACING_PT,nb as MAX_STYLE_BASED_ON_DEPTH,ob as MAX_STYLE_DEFINITIONS,yb as MAX_TABLE_BORDER_STROKES,Hb as MAX_TABLE_NESTING,oc as MAX_TABLE_ROW_FRAGMENTS,Jb as MAX_TABLE_ROW_HEIGHT_PT,za as MAX_TAB_POSITION_TWIPS,ya as MAX_TAB_STOPS,ga as PARAGRAPH_BORDER_SIDES,P as ResolvedCache,fa as SINGLE_LINE_SPACING,Ca as TAB_LEADER_GLYPH,pc as TablePaginationError,n as UnsupportedScriptError,E as WORD_SEGMENTER_LOCALE,sa as appliedSpaceBefore,ja as applyLineSpacing,$c as attachNotesToLayout,gb as baselineShiftPtOf,Fb as borderExtentPt,Cb as borderWeight,pa as bottomBorderExtentPt,H as boundedFallbackWordSegments,Pb as buildNumberingIndex,Yc as buildPageRefIndex,qb as buildStyleCascadeTable,N as captureOperationSnapshot,pd as caretAt,hc as caretBoxOnLine,nd as caretStops,od as caretStopsForBlocks,rb as cascadeParagraphFormatting,tb as cascadeRunProperties,sb as cascadedBottomBorder,ma as cascadedParagraphBorders,Ea as cascadedTabStops,Bd as cellSelectionBetween,Ed as cellSelectionRects,Fd as cellSelectionText,Na as clampListValue,ra as collapsedSpaceBefore,zd as compositionAnchor,aa as computeDoubleBorderMetricsPt,_c as computeFootnoteReserves,ec as contentControlAtPoint,rd as contentControlAtSemantic,jd as contentControlBoundaries,sd as contentControlsInLayout,X as contentControlsOfLayout,I as createBoundedFallbackWordBoundary,J as createDefaultWordBoundary,dd as createFixedMeasurer,m as createHarfBuzzTextShaper,G as createIntlWordBoundary,md as createLayoutScheduler,cd as createLayoutSession,Sb as createListCounterState,jb as createParagraphLayoutCache,kd as createShapedMeasurer,e as createShapedRun,b as createShapingEnvironment,Pc as defaultNoteSeparatorRuleStyle,Ha as defaultTabIntervalFromSettings,Fc as deriveNoteDisplayMarks,Gc as deriveNoteDisplayMarksResolved,db as displayText,vd as documentOrder,xb as effectiveBorderSide,Z as effectiveContentControlLock,uc as emptyTocPlaceholderParagraphIds,vc as emptyTocSuppressedResultParagraphIds,Cc as enumerateDocumentSections,Dc as enumerateDocumentSectionsBounded,Va as expandLvlText,Zc as filterRefsOnPage,ic as findDrawingOverlayFrameInLayout,Mc as findSeparatorNote,a as fixedPoint,Oa as formatDecimal,Pa as formatDecimalZero,Ta as formatLowerLetter,Ra as formatLowerRoman,Ua as formatNumFmt,hb as formatPageNumber,$a as formatRevisionOf,Sa as formatUpperLetter,Qa as formatUpperRoman,Xc as fragmentOwnsAtomOffset,V as fragmentsOfParagraph,Ec as geometryOfSection,s as graphemeBoundaryEpoch,w as graphemeCount,y as graphemeOffsetToUtf16,O as guardOperationSnapshot,k as harfBuzzFontValidator,bc as hitTestPage,qd as hitTestSemantic,dc as hitTestSheet,h as initializeHarfBuzz,r as intlGraphemeBoundary,gd as isCanvasMeasurementAvailable,C as isCumulativeGeometryTrustedFromLineOrigin,ac as isFurniturePoint,B as isGeometryTrustedCaretOffset,i as isHarfBuzzInitialized,q as isIntlSegmenterAvailable,F as isIntlWordSegmenterAvailable,Qc as isMarkerOnlySeparatorNote,pb as isValidStyleId,A as isWholeGraphemeHorizontalBoundary,o as itemizeScriptFontSlots,ud as keyedRangeRects,bd as layoutHeaderFooterStory,Oc as layoutNoteById,Rc as layoutNoteSeparator,Nc as layoutNoteStory,ed as layoutSemanticDocument,W as lineAtPosition,fc as lineEndOffset,T as linesOf,Zb as listMarkerBox,eb as measureDisplayText,Vb as mergeListIndent,yd as moveCaret,Ia as nextTabDestination,Lc as normalNotesOf,Hc as noteDisplayMarkMap,Kc as noteLineIdPrefix,Wa as noteMarkKey,Tc as noteSeparatorAreaBox,rc as noteStoryBlocks,$b as pageAtY,ld as pagesToMaterialize,oa as paragraphBorderExtentPt,na as paragraphBorderStrokeWidthPt,la as paragraphBorders,qa as paragraphBordersFingerprint,ba as paragraphBreaksBefore,ka as paragraphContextualSpacing,R as paragraphFragmentsOf,S as paragraphFragmentsOfBlocks,ib as paragraphLayoutKey,ia as paragraphLineSpacing,vb as paragraphMarkDeleted,_a as paragraphMarkRevisionOf,Ac as paragraphSectionNode,wa as paragraphShading,xa as paragraphShadingBox,ha as paragraphSpacing,Fa as paragraphTabStops,wd as paragraphTextFromLayout,Cd as paragraphsInCells,yc as parsePageNumbering,zc as parseSectionProperties,Xa as projectedNoteMarkText,ad as provisionalNoteMarks,zb as readBorderSide,Bb as readCellBorders,Tb as readNumPr,Bc as readSectionProperties,Ab as readTableBorders,Mb as readTableStructure,v as resetGraphemeBoundary,Db as resolveBorderConflict,id as resolveDefaultSurfaceMeasurer,K as resolveDefaultWordBoundary,Qb as resolveNumberingLevel,ua as resolveOoxmlShadingFill,ub as resolveParagraphLayoutInputs,cb as resolveRunStyle,Xb as resolveStoryListItems,ta as resolveStrictHexFill,Eb as resolveTableCellBorderGrid,wb as revisionRemovesParagraph,ab as revisionsAreDeletion,Za as revisionsVisible,l as roundFontUnitToFixedPoint,fb as runStylesEqual,t as segmentGraphemes,L as segmentWords,td as selectionRects,D as semanticHorizontalBoundaries,u as setGraphemeBoundary,va as shadingFillFromElement,z as shapedHorizontalBoundaries,f as shapedRunComparatorInputs,d as shapingEnvironmentFingerprint,c as shapingEnvironmentFingerprintInputs,gc as spanOffsetX,Dd as spansInCells,Ad as spansInSelection,qc as storyBlocks,Sc as syntheticSeparatorBox,Ja as tabAdvanceWidth,Ka as tabStopsFingerprint,Gd as tableContextAt,Lb as tableOriginX,tc as tocFieldChromeParagraphIds,hd as tryCreateCanvasMeasurer,Y as unionLayoutBoxes,x as utf16OffsetToGrapheme,Wb as walkStoryParagraphs,Ga as withDefaultTabInterval,Ub as withNumberingStyleLinks,Yb as withResolvedListItems,xd as wordBoundary,M as wordSegmentsToGraphemeRecords}from'./chunk-HVAV2JSN.js';export{a as W15_NAMESPACE_URI,j as activeReviewItem,c as commentBodyText,d as commentInitials,g as firstReviewRange,e as paragraphOrderOfPart,l as reviewAnchorIndex,m as reviewItemGeometry,b as reviewItemKey,h as reviewItemPositionRank,f as reviewItemRanges,i as reviewItemsAt,k as reviewThreadRootOf}from'./chunk-ZUALAR4M.js';import'./chunk-DOEIARE2.js';export{d as FontResolutionError,c as HARD_MAX_AGGREGATE_FONT_BYTES,a as HARD_MAX_FONT_BYTES,b as HARD_MAX_FONT_SOURCES,Hb as MAX_SDT_NESTING,Le as MAX_TABLE_COLUMNS,j as boundedStructuralFontValidator,Mb as collectFlowBlocks,Lb as contentControlContentChildren,k as createFontResourceSnapshot,e as fontRequestKey,Ib as isContentControl,Jb as isContentControlContent,i as sha256FontBytes}from'./chunk-RNBHTPW7.js';

package/dist/note-nodes-BPSTVDMr.d.ts

@@ -0,0 +1,108 @@
+import { O as OoxmlNode, f as OoxmlParagraphNode, g as OoxmlNoteNode, h as OoxmlContinuationSeparatorNode, i as OoxmlEndnotesNode, j as OoxmlFootnotesNode, k as OoxmlNoteRefNode, l as OoxmlNoteReferenceNode, m as OoxmlSeparatorNode } from './ooxml-tree-BU0e3DVi.js';
+
+/** UTF-16 placeholder for one atomic note unit in `paragraphTextOf` / segments. */
+declare const NOTE_ATOM_CHAR = "\uFFFC";
+/** Signed 32-bit Word-compatible note id range (positive allocation only). */
+declare const NOTE_ID_MIN = 1;
+/** Largest note id Word accepts — signed 32-bit. */
+declare const NOTE_ID_MAX = 2147483647;
+/** Reserved separator / continuation ids — never allocated for normal notes. */
+declare const NOTE_SEPARATOR_ID = -1;
+/** Reserved id of the continuation-separator entry. Never allocated to a real note. */
+declare const NOTE_CONTINUATION_SEPARATOR_ID = 0;
+/** Which notes part a note lives in. Decides both placement and numbering rules. */
+type NoteKind = 'footnote' | 'endnote';
+/** Authored `ST_FtnEdn` including explicit `normal`. Absent means Word default (normal). */
+/**
+ * What a note entry IS.
+ *
+ * Only `normal` is a note a reader sees. The others are the furniture Word stores in the same
+ * part — the rules and notices drawn around the note area — reached by reserved ids.
+ */
+type NoteType = 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
+/** Parse a signed decimal note id; reject non-integers and out-of-int32 values. */
+declare function parseNoteId(raw: string | undefined): number | null;
+/**
+ * Canonical `EditorScope { kind: 'note'; id }` encoding.
+ *
+ * Footnote id `1` and endnote id `1` coexist, so the kind is part of the string:
+ * `footnote:2` / `endnote:-1`. Do not invent a parallel scope union arm.
+ */
+declare function formatNoteScopeId(noteKind: NoteKind, noteId: number): string;
+/**
+ * Parse {@link formatNoteScopeId}. Returns `null` for malformed / out-of-range ids.
+ */
+declare function parseNoteScopeId(id: string): {
+    readonly noteKind: NoteKind;
+    readonly noteId: number;
+} | null;
+/** Whether a node is a `w:footnotes` part root. */
+declare function isFootnotesNode(node: OoxmlNode): node is OoxmlFootnotesNode;
+/** Whether a node is a `w:endnotes` part root. */
+declare function isEndnotesNode(node: OoxmlNode): node is OoxmlEndnotesNode;
+/** Whether a node is a `w:footnote` or `w:endnote` body. */
+declare function isNoteNode(node: OoxmlNode): node is OoxmlNoteNode;
+/** Whether a node is a body-side `w:footnoteReference` / `w:endnoteReference`. */
+declare function isNoteReferenceNode(node: OoxmlNode): node is OoxmlNoteReferenceNode;
+/** Whether a node is the `w:footnoteRef` / `w:endnoteRef` mark inside a note's own body. */
+declare function isNoteRefNode(node: OoxmlNode): node is OoxmlNoteRefNode;
+/** Whether a node is the `w:separator` rule drawn above the note area. */
+declare function isSeparatorNode(node: OoxmlNode): node is OoxmlSeparatorNode;
+/** Whether a node is the `w:continuationSeparator` rule used on continuation pages. */
+declare function isContinuationSeparatorNode(node: OoxmlNode): node is OoxmlContinuationSeparatorNode;
+/** Typed or generic `w:footnote` / `w:endnote`. */
+declare function noteKindOf(node: OoxmlNode): NoteKind | null;
+/** Authored `@w:id` on a note or noteReference when parseable. */
+declare function noteIdOf(node: OoxmlNode): number | null;
+/** Authored `@w:type` (`ST_FtnEdn`) when present and schema-legal; else `undefined`. */
+declare function noteTypeOf(node: OoxmlNode): NoteType | undefined;
+/** Whether a note is a normal (body) note — absent type and explicit `normal` both count. */
+declare function isNormalNote(node: OoxmlNode): boolean;
+/** Typed or generic footnote/endnote reference kind. */
+declare function noteReferenceKindOf(node: OoxmlNode): NoteKind | null;
+/** Typed or generic `w:footnoteRef` / `w:endnoteRef`. */
+declare function noteRefKindOf(node: OoxmlNode): NoteKind | null;
+/**
+ * Read `@w:customMarkFollows` on a note reference.
+ * Returns `undefined` when absent; otherwise the OOXML on/off interpretation.
+ */
+declare function customMarkFollows(node: OoxmlNode): boolean | undefined;
+/** Model text contributed by one atomic note unit. */
+declare function noteAtomText(): typeof NOTE_ATOM_CHAR;
+/**
+ * True when a run-inner node is a typed note atom that contributes one UTF-16 unit.
+ * Demoted/malformed known locals stay generic and contribute nothing.
+ */
+declare function isNoteAtomNode(node: OoxmlNode): boolean;
+/**
+ * One atomic note span inside a paragraph for caret / delete / selection.
+ *
+ * Each typed note atom is a single-node span (`removeNodeIds` = that node).
+ */
+interface AtomicNoteSpan {
+    readonly kind: 'noteReference' | 'noteRef' | 'separator' | 'continuationSeparator';
+    readonly node: OoxmlNode;
+    readonly runId: string;
+    readonly removeNodeIds: readonly string[];
+}
+/**
+ * Collect typed note atoms in document order (one segment each).
+ *
+ * Walks the same paragraph-inline surface as `segmentsOf` / `walkParagraphInline`:
+ * hyperlinks and content controls flatten; only direct run children contribute atoms.
+ * A demoted run-inner SDT husk stays opaque — no phantom addressable hit.
+ */
+declare function atomicNoteSpansOf(paragraph: OoxmlParagraphNode): readonly AtomicNoteSpan[];
+/** Cap on notes scanned when allocating / indexing a notes part. */
+declare const MAX_NOTES_PER_PART = 10000;
+/**
+ * Allocate the next positive signed 32-bit note id for a notes-part root.
+ * Seeds from `max(existing)+1`; never returns ≤0; `null` on exhaustion.
+ */
+declare function allocateNoteId(notesRoot: OoxmlNode): number | null;
+/** Collect note bodies from a footnotes/endnotes root, bounded. */
+declare function notesOf(root: OoxmlNode): readonly OoxmlNoteNode[];
+/** Find a typed note by id inside a notes-part root. */
+declare function findNoteById(root: OoxmlNode, noteId: number): OoxmlNoteNode | undefined;
+
+export { type AtomicNoteSpan as A, notesOf as B, parseNoteId as C, parseNoteScopeId as D, MAX_NOTES_PER_PART as M, type NoteKind as N, NOTE_ATOM_CHAR as a, NOTE_CONTINUATION_SEPARATOR_ID as b, NOTE_ID_MAX as c, NOTE_ID_MIN as d, NOTE_SEPARATOR_ID as e, type NoteType as f, allocateNoteId as g, atomicNoteSpansOf as h, customMarkFollows as i, findNoteById as j, formatNoteScopeId as k, isContinuationSeparatorNode as l, isEndnotesNode as m, noteTypeOf as n, isFootnotesNode as o, isNormalNote as p, isNoteAtomNode as q, isNoteNode as r, isNoteRefNode as s, isNoteReferenceNode as t, isSeparatorNode as u, noteAtomText as v, noteIdOf as w, noteKindOf as x, noteRefKindOf as y, noteReferenceKindOf as z };

package/dist/note-nodes-C6DLxlvj.d.cts

@@ -0,0 +1,108 @@
+import { O as OoxmlNode, f as OoxmlParagraphNode, g as OoxmlNoteNode, h as OoxmlContinuationSeparatorNode, i as OoxmlEndnotesNode, j as OoxmlFootnotesNode, k as OoxmlNoteRefNode, l as OoxmlNoteReferenceNode, m as OoxmlSeparatorNode } from './ooxml-tree-BU0e3DVi.cjs';
+
+/** UTF-16 placeholder for one atomic note unit in `paragraphTextOf` / segments. */
+declare const NOTE_ATOM_CHAR = "\uFFFC";
+/** Signed 32-bit Word-compatible note id range (positive allocation only). */
+declare const NOTE_ID_MIN = 1;
+/** Largest note id Word accepts — signed 32-bit. */
+declare const NOTE_ID_MAX = 2147483647;
+/** Reserved separator / continuation ids — never allocated for normal notes. */
+declare const NOTE_SEPARATOR_ID = -1;
+/** Reserved id of the continuation-separator entry. Never allocated to a real note. */
+declare const NOTE_CONTINUATION_SEPARATOR_ID = 0;
+/** Which notes part a note lives in. Decides both placement and numbering rules. */
+type NoteKind = 'footnote' | 'endnote';
+/** Authored `ST_FtnEdn` including explicit `normal`. Absent means Word default (normal). */
+/**
+ * What a note entry IS.
+ *
+ * Only `normal` is a note a reader sees. The others are the furniture Word stores in the same
+ * part — the rules and notices drawn around the note area — reached by reserved ids.
+ */
+type NoteType = 'normal' | 'separator' | 'continuationSeparator' | 'continuationNotice';
+/** Parse a signed decimal note id; reject non-integers and out-of-int32 values. */
+declare function parseNoteId(raw: string | undefined): number | null;
+/**
+ * Canonical `EditorScope { kind: 'note'; id }` encoding.
+ *
+ * Footnote id `1` and endnote id `1` coexist, so the kind is part of the string:
+ * `footnote:2` / `endnote:-1`. Do not invent a parallel scope union arm.
+ */
+declare function formatNoteScopeId(noteKind: NoteKind, noteId: number): string;
+/**
+ * Parse {@link formatNoteScopeId}. Returns `null` for malformed / out-of-range ids.
+ */
+declare function parseNoteScopeId(id: string): {
+    readonly noteKind: NoteKind;
+    readonly noteId: number;
+} | null;
+/** Whether a node is a `w:footnotes` part root. */
+declare function isFootnotesNode(node: OoxmlNode): node is OoxmlFootnotesNode;
+/** Whether a node is a `w:endnotes` part root. */
+declare function isEndnotesNode(node: OoxmlNode): node is OoxmlEndnotesNode;
+/** Whether a node is a `w:footnote` or `w:endnote` body. */
+declare function isNoteNode(node: OoxmlNode): node is OoxmlNoteNode;
+/** Whether a node is a body-side `w:footnoteReference` / `w:endnoteReference`. */
+declare function isNoteReferenceNode(node: OoxmlNode): node is OoxmlNoteReferenceNode;
+/** Whether a node is the `w:footnoteRef` / `w:endnoteRef` mark inside a note's own body. */
+declare function isNoteRefNode(node: OoxmlNode): node is OoxmlNoteRefNode;
+/** Whether a node is the `w:separator` rule drawn above the note area. */
+declare function isSeparatorNode(node: OoxmlNode): node is OoxmlSeparatorNode;
+/** Whether a node is the `w:continuationSeparator` rule used on continuation pages. */
+declare function isContinuationSeparatorNode(node: OoxmlNode): node is OoxmlContinuationSeparatorNode;
+/** Typed or generic `w:footnote` / `w:endnote`. */
+declare function noteKindOf(node: OoxmlNode): NoteKind | null;
+/** Authored `@w:id` on a note or noteReference when parseable. */
+declare function noteIdOf(node: OoxmlNode): number | null;
+/** Authored `@w:type` (`ST_FtnEdn`) when present and schema-legal; else `undefined`. */
+declare function noteTypeOf(node: OoxmlNode): NoteType | undefined;
+/** Whether a note is a normal (body) note — absent type and explicit `normal` both count. */
+declare function isNormalNote(node: OoxmlNode): boolean;
+/** Typed or generic footnote/endnote reference kind. */
+declare function noteReferenceKindOf(node: OoxmlNode): NoteKind | null;
+/** Typed or generic `w:footnoteRef` / `w:endnoteRef`. */
+declare function noteRefKindOf(node: OoxmlNode): NoteKind | null;
+/**
+ * Read `@w:customMarkFollows` on a note reference.
+ * Returns `undefined` when absent; otherwise the OOXML on/off interpretation.
+ */
+declare function customMarkFollows(node: OoxmlNode): boolean | undefined;
+/** Model text contributed by one atomic note unit. */
+declare function noteAtomText(): typeof NOTE_ATOM_CHAR;
+/**
+ * True when a run-inner node is a typed note atom that contributes one UTF-16 unit.
+ * Demoted/malformed known locals stay generic and contribute nothing.
+ */
+declare function isNoteAtomNode(node: OoxmlNode): boolean;
+/**
+ * One atomic note span inside a paragraph for caret / delete / selection.
+ *
+ * Each typed note atom is a single-node span (`removeNodeIds` = that node).
+ */
+interface AtomicNoteSpan {
+    readonly kind: 'noteReference' | 'noteRef' | 'separator' | 'continuationSeparator';
+    readonly node: OoxmlNode;
+    readonly runId: string;
+    readonly removeNodeIds: readonly string[];
+}
+/**
+ * Collect typed note atoms in document order (one segment each).
+ *
+ * Walks the same paragraph-inline surface as `segmentsOf` / `walkParagraphInline`:
+ * hyperlinks and content controls flatten; only direct run children contribute atoms.
+ * A demoted run-inner SDT husk stays opaque — no phantom addressable hit.
+ */
+declare function atomicNoteSpansOf(paragraph: OoxmlParagraphNode): readonly AtomicNoteSpan[];
+/** Cap on notes scanned when allocating / indexing a notes part. */
+declare const MAX_NOTES_PER_PART = 10000;
+/**
+ * Allocate the next positive signed 32-bit note id for a notes-part root.
+ * Seeds from `max(existing)+1`; never returns ≤0; `null` on exhaustion.
+ */
+declare function allocateNoteId(notesRoot: OoxmlNode): number | null;
+/** Collect note bodies from a footnotes/endnotes root, bounded. */
+declare function notesOf(root: OoxmlNode): readonly OoxmlNoteNode[];
+/** Find a typed note by id inside a notes-part root. */
+declare function findNoteById(root: OoxmlNode, noteId: number): OoxmlNoteNode | undefined;
+
+export { type AtomicNoteSpan as A, notesOf as B, parseNoteId as C, parseNoteScopeId as D, MAX_NOTES_PER_PART as M, type NoteKind as N, NOTE_ATOM_CHAR as a, NOTE_CONTINUATION_SEPARATOR_ID as b, NOTE_ID_MAX as c, NOTE_ID_MIN as d, NOTE_SEPARATOR_ID as e, type NoteType as f, allocateNoteId as g, atomicNoteSpansOf as h, customMarkFollows as i, findNoteById as j, formatNoteScopeId as k, isContinuationSeparatorNode as l, isEndnotesNode as m, noteTypeOf as n, isFootnotesNode as o, isNormalNote as p, isNoteAtomNode as q, isNoteNode as r, isNoteRefNode as s, isNoteReferenceNode as t, isSeparatorNode as u, noteAtomText as v, noteIdOf as w, noteKindOf as x, noteRefKindOf as y, noteReferenceKindOf as z };

package/dist/note-properties-CnmCoory.d.cts

@@ -0,0 +1,68 @@
+import { e as OoxmlPart, O as OoxmlNode } from './ooxml-tree-BU0e3DVi.cjs';
+import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.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;
+
+export { type AuthoredNoteProperties as A, DEFAULT_ENDNOTE_PROPERTIES as D, type EndnotePosition as E, type FootnotePosition as F, type NoteNumRestart as N, type ResolvedFootnoteProperties as R, type ResolvedEndnoteProperties as a, DEFAULT_FOOTNOTE_PROPERTIES as b, authoredDocumentEndnoteProperties as c, authoredDocumentFootnoteProperties as d, authoredEndnotePropertiesFromSectPr as e, authoredFootnotePropertiesFromSectPr as f, isLegalFootnotePosition as g, isLegalNumRestart as h, isLegalEndnotePosition as i, resolveFootnoteProperties as j, parseAuthoredNoteProperties as p, resolveEndnoteProperties as r, settingsPartOf as s };

package/dist/note-properties-m75hmP70.d.ts

@@ -0,0 +1,68 @@
+import { e as OoxmlPart, O as OoxmlNode } from './ooxml-tree-BU0e3DVi.js';
+import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
+
+/** `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, DEFAULT_ENDNOTE_PROPERTIES as D, type EndnotePosition as E, type FootnotePosition as F, type NoteNumRestart as N, type ResolvedFootnoteProperties as R, type ResolvedEndnoteProperties as a, DEFAULT_FOOTNOTE_PROPERTIES as b, authoredDocumentEndnoteProperties as c, authoredDocumentFootnoteProperties as d, authoredEndnotePropertiesFromSectPr as e, authoredFootnotePropertiesFromSectPr as f, isLegalFootnotePosition as g, isLegalNumRestart as h, isLegalEndnotePosition as i, resolveFootnoteProperties as j, parseAuthoredNoteProperties as p, resolveEndnoteProperties as r, settingsPartOf as s };