@zeke-02/docx-editor-core 0.1.0

package/dist/utils/comments.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Framework-agnostic comment + tracked-change helpers shared by the
+ * React and Vue adapters. The data shapes and string-formatting rules
+ * here are part of the visible UI (avatar colors, date strings) so
+ * keep this file as the single source of truth — both adapters import
+ * from here. CSS-property factories live in adapter-specific files
+ * (sidebar/cardUtils.ts in React, sidebar/sidebarUtils.ts in Vue).
+ * @packageDocumentation
+ * @public
+ */
+import { P as Paragraph } from '../content-CmqAwdFL.js';
+import '../formatting-_OXU8gLB.js';
+import '../colors-C3vA7HUU.js';
+import '../docx/wrapTypes.js';
+
+/**
+ * Framework-agnostic comment + tracked-change helpers shared by the
+ * React and Vue adapters. The data shapes and string-formatting rules
+ * here are part of the visible UI (avatar colors, date strings) so
+ * keep this file as the single source of truth — both adapters import
+ * from here. CSS-property factories live in adapter-specific files
+ * (sidebar/cardUtils.ts in React, sidebar/sidebarUtils.ts in Vue).
+ * @packageDocumentation
+ * @public
+ */
+
+/** Extract plain text from a Comment's paragraph content. */
+declare function getCommentText(paragraphs?: Paragraph[]): string;
+declare function formatDate(dateStr?: string): string;
+declare function getInitials(name: string): string;
+declare function getAvatarColor(name: string): string;
+declare function truncateText(text: string, maxLength?: number): string;
+/**
+ * One tracked change surfaced by `extractTrackedChanges`. Each entry
+ * groups all sites of one revision into a single row that the sidebar
+ * renders as one card. Resolve via {@link acceptChangeById} /
+ * {@link rejectChangeById} for any type — the by-id resolver walks
+ * every site sharing the id so coalesced edits clear in one click.
+ *
+ * @public
+ */
+interface TrackedChangeEntry {
+    /**
+     * Revision shape. Inline shapes (`insertion`, `deletion`, `replacement`)
+     * wrap text runs; the rest are structural revisions on node attrs.
+     *
+     * - `insertion` — text was added (`<w:ins>`).
+     * - `deletion` — text was struck through but not removed (`<w:del>`).
+     * - `replacement` — a deletion + insertion by the same author at the
+     *   same position+time; sidebar shows one combined card. `deletedText`
+     *   and `insertionRevisionId` are set on this variant.
+     * - `paragraphMarkInsertion` / `paragraphMarkDeletion` — Enter /
+     *   Backspace produced a tracked paragraph break (`<w:pPr><w:rPr><w:ins/>` /
+     *   `<w:del/>`).
+     * - `paragraphPropertiesChanged` — formatting (alignment, spacing,
+     *   etc.) on the paragraph was changed (`<w:pPrChange>`).
+     * - `rowInserted` / `rowDeleted` / `rowPropertiesChanged` — table
+     *   row authored / removed / formatted (`<w:trPr><w:ins/>` / `<w:del/>`
+     *   / `<w:trPrChange>`).
+     * - `cellInserted` / `cellDeleted` / `cellMerged` /
+     *   `cellPropertiesChanged` — per-cell revisions
+     *   (`<w:cellIns>` / `<w:cellDel>` / `<w:cellMerge>` / `<w:tcPrChange>`).
+     * - `tablePropertiesChanged` — table-level formatting
+     *   (`<w:tblPrChange>`).
+     */
+    type: 'insertion' | 'deletion' | 'replacement' | 'paragraphMarkInsertion' | 'paragraphMarkDeletion' | 'paragraphPropertiesChanged' | 'rowInserted' | 'rowDeleted' | 'rowPropertiesChanged' | 'cellInserted' | 'cellDeleted' | 'cellMerged' | 'cellPropertiesChanged' | 'tableInserted' | 'tableDeleted' | 'tablePropertiesChanged';
+    /**
+     * Affected text. For inline types this is the run's text; for
+     * structural types it's the surrounding paragraph / cell content
+     * (truncated by the sidebar before display).
+     */
+    text: string;
+    /**
+     * Only set when `type === 'replacement'` — the text the user removed.
+     * The inserted text lives in {@link TrackedChangeEntry.text}.
+     */
+    deletedText?: string;
+    /** Author that minted the revision (`w:author`). */
+    author: string;
+    /** ISO timestamp the revision was minted (`w:date`). May be undefined for legacy imports. */
+    date?: string;
+    /**
+     * Document position where the revision starts. For inline types this
+     * is the start of the marked text run; for structural types it's the
+     * containing paragraph / row / cell / table node's start position.
+     * Used by the sidebar to anchor the card at the correct vertical
+     * offset.
+     */
+    from: number;
+    /**
+     * Document position where the revision ends. For inline coalesced
+     * runs that span multiple paragraphs, this is the END position of the
+     * LAST run in the group; the intervening structural positions are not
+     * preserved.
+     */
+    to: number;
+    /**
+     * The `w:id` of the revision. Pass to
+     * {@link acceptChangeById} / {@link rejectChangeById} to resolve every
+     * site sharing this id — including pPrIns paragraph attrs and
+     * subsequent typed runs in the same editing session.
+     */
+    revisionId: number;
+    /**
+     * Only set when `type === 'replacement'` — the insertion half carries
+     * a DIFFERENT `w:id` from the deletion (sharing would trip the OOXML
+     * move-pair serializer). Card Accept handlers dispatch BOTH ids to
+     * clear the deletion and the insertion + any coalesced paragraph-marks.
+     */
+    insertionRevisionId?: number;
+    /**
+     * Extra `w:id`s that map to the same logical revision as this card.
+     * Populated when the extractor coalesces a burst of distinct ids by
+     * (author, date) — e.g. a foreign document where the source editor
+     * minted a fresh id per atomic edit. Accept/reject handlers must
+     * resolve every id in this list in addition to {@link revisionId}.
+     */
+    coalescedRevisionIds?: number[];
+}
+
+export { type TrackedChangeEntry, formatDate, getAvatarColor, getCommentText, getInitials, truncateText };

package/dist/utils/comments.js

@@ -0,0 +1 @@
+'use strict';require('../chunk-DC7S76ZX.js');function i(e){return e?.length?e.flatMap(r=>r.content.filter(t=>t.type==="run").flatMap(t=>"content"in t?t.content:[]).filter(t=>t.type==="text").map(t=>"text"in t?t.text:"")).join(""):""}function o(e){return e?new Date(e).toLocaleString(void 0,{hour:"numeric",minute:"2-digit",month:"short",day:"numeric"}):""}function a(e){return e.split(/\s+/).map(r=>r[0]).join("").toUpperCase().slice(0,2)}var n=["#6DCCB1","#79AAD9","#EE789D","#A987D1","#E6A85F","#F2CC8F","#68B3A2","#B07AA1","#59A14F","#FF9DA7","#E15759","#76B7B2"];function s(e){let r=0;for(let t=0;t<e.length;t++)r=e.charCodeAt(t)+((r<<5)-r);return n[Math.abs(r)%n.length]}function l(e,r=50){return e.length>r?e.slice(0,r)+"...":e}exports.formatDate=o;exports.getAvatarColor=s;exports.getCommentText=i;exports.getInitials=a;exports.truncateText=l;

package/dist/utils/comments.mjs

@@ -0,0 +1 @@
+import'../chunk-QYUPLKLP.mjs';function i(e){return e?.length?e.flatMap(r=>r.content.filter(t=>t.type==="run").flatMap(t=>"content"in t?t.content:[]).filter(t=>t.type==="text").map(t=>"text"in t?t.text:"")).join(""):""}function o(e){return e?new Date(e).toLocaleString(void 0,{hour:"numeric",minute:"2-digit",month:"short",day:"numeric"}):""}function a(e){return e.split(/\s+/).map(r=>r[0]).join("").toUpperCase().slice(0,2)}var n=["#6DCCB1","#79AAD9","#EE789D","#A987D1","#E6A85F","#F2CC8F","#68B3A2","#B07AA1","#59A14F","#FF9DA7","#E15759","#76B7B2"];function s(e){let r=0;for(let t=0;t<e.length;t++)r=e.charCodeAt(t)+((r<<5)-r);return n[Math.abs(r)%n.length]}function l(e,r=50){return e.length>r?e.slice(0,r)+"...":e}export{o as formatDate,s as getAvatarColor,i as getCommentText,a as getInitials,l as truncateText};

package/dist/utils/findReplace.d.mts

@@ -0,0 +1,114 @@
+/**
+ * Find & Replace Utility Functions
+ *
+ * Pure utility functions for text search, pattern matching, and
+ * document search. Lifted from packages/react/src/components/dialogs/
+ * findReplaceUtils.ts so the React adapter and the Vue adapter share
+ * one implementation.
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * A single match result in the document
+ */
+interface FindMatch {
+    /** Index of the paragraph containing the match */
+    paragraphIndex: number;
+    /** Index of the run/content within the paragraph */
+    contentIndex: number;
+    /** Character offset within the content */
+    startOffset: number;
+    /** Character offset for end of match */
+    endOffset: number;
+    /** The matched text */
+    text: string;
+}
+/**
+ * Find options for controlling search behavior
+ */
+interface FindOptions {
+    /** Whether to match case */
+    matchCase: boolean;
+    /** Whether to match whole words only */
+    matchWholeWord: boolean;
+    /** Whether to use regular expressions (future) */
+    useRegex?: boolean;
+}
+/**
+ * Find result with all matches
+ */
+interface FindResult {
+    /** All matches found */
+    matches: FindMatch[];
+    /** Total match count */
+    totalCount: number;
+    /** Current match index (0-based) */
+    currentIndex: number;
+}
+/**
+ * Highlight options for document rendering
+ */
+interface HighlightOptions {
+    /** Background color for current match */
+    currentMatchColor: string;
+    /** Background color for other matches */
+    otherMatchColor: string;
+}
+/**
+ * Create default find options
+ */
+declare function createDefaultFindOptions(): FindOptions;
+/**
+ * Escape string for use in regex pattern
+ */
+declare function escapeRegexString(str: string): string;
+/**
+ * Create a regex pattern from search text and options
+ */
+declare function createSearchPattern(searchText: string, options: FindOptions): RegExp | null;
+/**
+ * Find all matches of search text in content
+ */
+declare function findAllMatches(content: string, searchText: string, options: FindOptions): Array<{
+    start: number;
+    end: number;
+}>;
+/**
+ * Replace text in content
+ */
+declare function replaceAllInContent(content: string, searchText: string, replaceText: string, options: FindOptions): string;
+/**
+ * Replace first match in content
+ */
+declare function replaceFirstInContent(content: string, searchText: string, replaceText: string, options: FindOptions, startIndex?: number): {
+    content: string;
+    replaced: boolean;
+    matchStart: number;
+    matchEnd: number;
+};
+/**
+ * Get match count for status display
+ */
+declare function getMatchCountText(result: FindResult | null): string;
+/**
+ * Check if search text is empty or whitespace-only
+ */
+declare function isEmptySearch(searchText: string): boolean;
+/**
+ * Get default highlight options
+ */
+declare function getDefaultHighlightOptions(): HighlightOptions;
+/**
+ * Find all matches in a document
+ */
+declare function findInDocument(document: any, searchText: string, options: FindOptions): FindMatch[];
+/**
+ * Find matches in a single paragraph
+ */
+declare function findInParagraph(paragraph: any, searchText: string, options: FindOptions, paragraphIndex: number): FindMatch[];
+/**
+ * Scroll to a match in the document
+ */
+declare function scrollToMatch(containerElement: HTMLElement | null, match: FindMatch): void;
+
+export { type FindMatch, type FindOptions, type FindResult, type HighlightOptions, createDefaultFindOptions, createSearchPattern, escapeRegexString, findAllMatches, findInDocument, findInParagraph, getDefaultHighlightOptions, getMatchCountText, isEmptySearch, replaceAllInContent, replaceFirstInContent, scrollToMatch };

package/dist/utils/findReplace.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Find & Replace Utility Functions
+ *
+ * Pure utility functions for text search, pattern matching, and
+ * document search. Lifted from packages/react/src/components/dialogs/
+ * findReplaceUtils.ts so the React adapter and the Vue adapter share
+ * one implementation.
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * A single match result in the document
+ */
+interface FindMatch {
+    /** Index of the paragraph containing the match */
+    paragraphIndex: number;
+    /** Index of the run/content within the paragraph */
+    contentIndex: number;
+    /** Character offset within the content */
+    startOffset: number;
+    /** Character offset for end of match */
+    endOffset: number;
+    /** The matched text */
+    text: string;
+}
+/**
+ * Find options for controlling search behavior
+ */
+interface FindOptions {
+    /** Whether to match case */
+    matchCase: boolean;
+    /** Whether to match whole words only */
+    matchWholeWord: boolean;
+    /** Whether to use regular expressions (future) */
+    useRegex?: boolean;
+}
+/**
+ * Find result with all matches
+ */
+interface FindResult {
+    /** All matches found */
+    matches: FindMatch[];
+    /** Total match count */
+    totalCount: number;
+    /** Current match index (0-based) */
+    currentIndex: number;
+}
+/**
+ * Highlight options for document rendering
+ */
+interface HighlightOptions {
+    /** Background color for current match */
+    currentMatchColor: string;
+    /** Background color for other matches */
+    otherMatchColor: string;
+}
+/**
+ * Create default find options
+ */
+declare function createDefaultFindOptions(): FindOptions;
+/**
+ * Escape string for use in regex pattern
+ */
+declare function escapeRegexString(str: string): string;
+/**
+ * Create a regex pattern from search text and options
+ */
+declare function createSearchPattern(searchText: string, options: FindOptions): RegExp | null;
+/**
+ * Find all matches of search text in content
+ */
+declare function findAllMatches(content: string, searchText: string, options: FindOptions): Array<{
+    start: number;
+    end: number;
+}>;
+/**
+ * Replace text in content
+ */
+declare function replaceAllInContent(content: string, searchText: string, replaceText: string, options: FindOptions): string;
+/**
+ * Replace first match in content
+ */
+declare function replaceFirstInContent(content: string, searchText: string, replaceText: string, options: FindOptions, startIndex?: number): {
+    content: string;
+    replaced: boolean;
+    matchStart: number;
+    matchEnd: number;
+};
+/**
+ * Get match count for status display
+ */
+declare function getMatchCountText(result: FindResult | null): string;
+/**
+ * Check if search text is empty or whitespace-only
+ */
+declare function isEmptySearch(searchText: string): boolean;
+/**
+ * Get default highlight options
+ */
+declare function getDefaultHighlightOptions(): HighlightOptions;
+/**
+ * Find all matches in a document
+ */
+declare function findInDocument(document: any, searchText: string, options: FindOptions): FindMatch[];
+/**
+ * Find matches in a single paragraph
+ */
+declare function findInParagraph(paragraph: any, searchText: string, options: FindOptions, paragraphIndex: number): FindMatch[];
+/**
+ * Scroll to a match in the document
+ */
+declare function scrollToMatch(containerElement: HTMLElement | null, match: FindMatch): void;
+
+export { type FindMatch, type FindOptions, type FindResult, type HighlightOptions, createDefaultFindOptions, createSearchPattern, escapeRegexString, findAllMatches, findInDocument, findInParagraph, getDefaultHighlightOptions, getMatchCountText, isEmptySearch, replaceAllInContent, replaceFirstInContent, scrollToMatch };

package/dist/utils/findReplace.js

@@ -0,0 +1,2 @@
+'use strict';require('../chunk-DC7S76ZX.js');function b(){return {matchCase:false,matchWholeWord:false,useRegex:false}}function g(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function p(t,e){if(!t)return null;try{let n;e.useRegex?n=t:n=g(t),e.matchWholeWord&&(n=`\\b${n}\\b`);let r=e.matchCase?"g":"gi";return new RegExp(n,r)}catch{return null}}function l(t,e,n){if(!t||!e)return [];let r=[],o=e;n.matchCase||(o=e.toLowerCase());let c=h=>h.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),i;n.matchWholeWord?i=`\\b${c(o)}\\b`:i=c(o);let a=n.matchCase?"g":"gi",s=new RegExp(i,a),f;for(;(f=s.exec(t))!==null;)r.push({start:f.index,end:f.index+f[0].length}),f[0].length===0&&s.lastIndex++;return r}function I(t,e,n,r){let o=p(e,r);return o?t.replace(o,n):t}function F(t,e,n,r,o=0){let c=l(t,e,r),i=c.find(s=>s.start>=o)||c[0];return i?{content:t.substring(0,i.start)+n+t.substring(i.end),replaced:true,matchStart:i.start,matchEnd:i.start+n.length}:{content:t,replaced:false,matchStart:-1,matchEnd:-1}}function y(t){return t?t.totalCount===0?"No results":t.totalCount===1?"1 match":`${t.currentIndex+1} of ${t.totalCount} matches`:""}function C(t){return !t||t.trim()===""}function M(){return {currentMatchColor:"#FFFF00",otherMatchColor:"#FFFFAA"}}function u(t){if(!t||!t.content)return "";let e="";for(let n of t.content)n.type==="text"?e+=n.text||"":n.type==="tab"?e+="	":n.type==="break"&&n.breakType==="textWrapping"&&(e+=`
+`);return e}function d(t){if(!t||!t.content)return "";let e="";for(let n of t.content)if(n.type==="run")e+=u(n);else if(n.type==="hyperlink")for(let r of n.children||[])r.type==="run"&&(e+=u(r));return e}function O(t,e,n){if(!t||!e)return [];let r=[],o=t.package?.document||t.package?.document;if(!o||!o.content)return r;let c=0;for(let i of o.content)if(i.type==="paragraph"){let a=x(i,e,n,c);r.push(...a),c++;}else if(i.type==="table")for(let a of i.rows||[])for(let s of a.cells||[])for(let f of s.content||[])f.type;return r}function x(t,e,n,r){let o=[],c=d(t);if(!c)return o;let i=l(c,e,n);for(let a of i){let s=m(t,a.start);o.push({paragraphIndex:r,contentIndex:s.contentIndex,startOffset:s.offsetInContent,endOffset:s.offsetInContent+(a.end-a.start),text:c.substring(a.start,a.end)});}return o}function m(t,e){if(!t||!t.content)return {contentIndex:0,runIndex:0,offsetInContent:e};let n=0,r=0;for(let o of t.content){let c="";if(o.type==="run")c=u(o);else if(o.type==="hyperlink")for(let a of o.children||[])a.type==="run"&&(c+=u(a));let i=c.length;if(n+i>e)return {contentIndex:r,runIndex:r,offsetInContent:e-n};n+=i,r++;}return {contentIndex:Math.max(0,t.content.length-1),runIndex:Math.max(0,t.content.length-1),offsetInContent:0}}function R(t,e){if(!t||!e)return;let n=t.querySelector(`[data-paragraph-index="${e.paragraphIndex}"]`);n&&n.scrollIntoView({behavior:"smooth",block:"center"});}exports.createDefaultFindOptions=b;exports.createSearchPattern=p;exports.escapeRegexString=g;exports.findAllMatches=l;exports.findInDocument=O;exports.findInParagraph=x;exports.getDefaultHighlightOptions=M;exports.getMatchCountText=y;exports.isEmptySearch=C;exports.replaceAllInContent=I;exports.replaceFirstInContent=F;exports.scrollToMatch=R;

package/dist/utils/findReplace.mjs

@@ -0,0 +1,2 @@
+import'../chunk-QYUPLKLP.mjs';function b(){return {matchCase:false,matchWholeWord:false,useRegex:false}}function g(t){return t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function p(t,e){if(!t)return null;try{let n;e.useRegex?n=t:n=g(t),e.matchWholeWord&&(n=`\\b${n}\\b`);let r=e.matchCase?"g":"gi";return new RegExp(n,r)}catch{return null}}function l(t,e,n){if(!t||!e)return [];let r=[],o=e;n.matchCase||(o=e.toLowerCase());let c=h=>h.replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),i;n.matchWholeWord?i=`\\b${c(o)}\\b`:i=c(o);let a=n.matchCase?"g":"gi",s=new RegExp(i,a),f;for(;(f=s.exec(t))!==null;)r.push({start:f.index,end:f.index+f[0].length}),f[0].length===0&&s.lastIndex++;return r}function I(t,e,n,r){let o=p(e,r);return o?t.replace(o,n):t}function F(t,e,n,r,o=0){let c=l(t,e,r),i=c.find(s=>s.start>=o)||c[0];return i?{content:t.substring(0,i.start)+n+t.substring(i.end),replaced:true,matchStart:i.start,matchEnd:i.start+n.length}:{content:t,replaced:false,matchStart:-1,matchEnd:-1}}function y(t){return t?t.totalCount===0?"No results":t.totalCount===1?"1 match":`${t.currentIndex+1} of ${t.totalCount} matches`:""}function C(t){return !t||t.trim()===""}function M(){return {currentMatchColor:"#FFFF00",otherMatchColor:"#FFFFAA"}}function u(t){if(!t||!t.content)return "";let e="";for(let n of t.content)n.type==="text"?e+=n.text||"":n.type==="tab"?e+="	":n.type==="break"&&n.breakType==="textWrapping"&&(e+=`
+`);return e}function d(t){if(!t||!t.content)return "";let e="";for(let n of t.content)if(n.type==="run")e+=u(n);else if(n.type==="hyperlink")for(let r of n.children||[])r.type==="run"&&(e+=u(r));return e}function O(t,e,n){if(!t||!e)return [];let r=[],o=t.package?.document||t.package?.document;if(!o||!o.content)return r;let c=0;for(let i of o.content)if(i.type==="paragraph"){let a=x(i,e,n,c);r.push(...a),c++;}else if(i.type==="table")for(let a of i.rows||[])for(let s of a.cells||[])for(let f of s.content||[])f.type;return r}function x(t,e,n,r){let o=[],c=d(t);if(!c)return o;let i=l(c,e,n);for(let a of i){let s=m(t,a.start);o.push({paragraphIndex:r,contentIndex:s.contentIndex,startOffset:s.offsetInContent,endOffset:s.offsetInContent+(a.end-a.start),text:c.substring(a.start,a.end)});}return o}function m(t,e){if(!t||!t.content)return {contentIndex:0,runIndex:0,offsetInContent:e};let n=0,r=0;for(let o of t.content){let c="";if(o.type==="run")c=u(o);else if(o.type==="hyperlink")for(let a of o.children||[])a.type==="run"&&(c+=u(a));let i=c.length;if(n+i>e)return {contentIndex:r,runIndex:r,offsetInContent:e-n};n+=i,r++;}return {contentIndex:Math.max(0,t.content.length-1),runIndex:Math.max(0,t.content.length-1),offsetInContent:0}}function R(t,e){if(!t||!e)return;let n=t.querySelector(`[data-paragraph-index="${e.paragraphIndex}"]`);n&&n.scrollIntoView({behavior:"smooth",block:"center"});}export{b as createDefaultFindOptions,p as createSearchPattern,g as escapeRegexString,l as findAllMatches,O as findInDocument,x as findInParagraph,M as getDefaultHighlightOptions,y as getMatchCountText,C as isEmptySearch,I as replaceAllInContent,F as replaceFirstInContent,R as scrollToMatch};

package/dist/utils/findVerticalScrollParent.d.mts

@@ -0,0 +1,25 @@
+/**
+ * Pure DOM helpers — locate the element that vertically scrolls the
+ * paginated editor. Lifted from packages/react/src/paged-editor/
+ * findVerticalScrollParent.ts so both adapters use the same logic
+ * for scroll-to-position, arrow-key line navigation, and drag
+ * auto-scroll.
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * First ancestor of `el` with `overflow-y: auto|scroll` and a scrollable
+ * overflow height. Walk starts at `el.parentElement` (does not treat
+ * `el` itself as the scroller).
+ *
+ * @returns `null` when no such ancestor exists before `document.documentElement`.
+ */
+declare function findVerticalScrollParent(el: HTMLElement): HTMLElement | null;
+/**
+ * Same as {@link findVerticalScrollParent} but falls back to
+ * `document.documentElement` so callers always get a valid scroll
+ * target (matches legacy `scrollIntoView` root).
+ */
+declare function findVerticalScrollParentOrRoot(el: HTMLElement): HTMLElement;
+
+export { findVerticalScrollParent, findVerticalScrollParentOrRoot };

package/dist/utils/findVerticalScrollParent.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pure DOM helpers — locate the element that vertically scrolls the
+ * paginated editor. Lifted from packages/react/src/paged-editor/
+ * findVerticalScrollParent.ts so both adapters use the same logic
+ * for scroll-to-position, arrow-key line navigation, and drag
+ * auto-scroll.
+ * @packageDocumentation
+ * @public
+ */
+/**
+ * First ancestor of `el` with `overflow-y: auto|scroll` and a scrollable
+ * overflow height. Walk starts at `el.parentElement` (does not treat
+ * `el` itself as the scroller).
+ *
+ * @returns `null` when no such ancestor exists before `document.documentElement`.
+ */
+declare function findVerticalScrollParent(el: HTMLElement): HTMLElement | null;
+/**
+ * Same as {@link findVerticalScrollParent} but falls back to
+ * `document.documentElement` so callers always get a valid scroll
+ * target (matches legacy `scrollIntoView` root).
+ */
+declare function findVerticalScrollParentOrRoot(el: HTMLElement): HTMLElement;
+
+export { findVerticalScrollParent, findVerticalScrollParentOrRoot };

package/dist/utils/findVerticalScrollParent.js

@@ -0,0 +1 @@
+'use strict';var chunkJY5EFI4D_js=require('../chunk-JY5EFI4D.js');require('../chunk-DC7S76ZX.js');Object.defineProperty(exports,"findVerticalScrollParent",{enumerable:true,get:function(){return chunkJY5EFI4D_js.a}});Object.defineProperty(exports,"findVerticalScrollParentOrRoot",{enumerable:true,get:function(){return chunkJY5EFI4D_js.b}});

package/dist/utils/findVerticalScrollParent.mjs

@@ -0,0 +1 @@
+export{a as findVerticalScrollParent,b as findVerticalScrollParentOrRoot}from'../chunk-RPIQG46O.mjs';import'../chunk-QYUPLKLP.mjs';

package/dist/utils/fontOptions.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Shared FontOption shape + normaliser used by FontPicker components
+ * in both adapters. Lifted from packages/react/src/components/ui/
+ * normalizeFontFamilies.ts so the type definition has a single home.
+ * @packageDocumentation
+ * @public
+ */
+interface FontOption {
+    name: string;
+    fontFamily: string;
+    category?: 'sans-serif' | 'serif' | 'monospace' | 'other';
+}
+/**
+ * Normalize a `fontFamilies` prop (mix of strings and FontOption
+ * objects) into a uniform `FontOption[]`. Returns `undefined` for
+ * `undefined` input so callers fall back to their built-in defaults.
+ * Strings expand into the `'other'` group with no CSS fallback chain.
+ */
+declare function normalizeFontFamilies(fontFamilies: ReadonlyArray<string | FontOption> | undefined): FontOption[] | undefined;
+
+export { type FontOption, normalizeFontFamilies };

package/dist/utils/fontOptions.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared FontOption shape + normaliser used by FontPicker components
+ * in both adapters. Lifted from packages/react/src/components/ui/
+ * normalizeFontFamilies.ts so the type definition has a single home.
+ * @packageDocumentation
+ * @public
+ */
+interface FontOption {
+    name: string;
+    fontFamily: string;
+    category?: 'sans-serif' | 'serif' | 'monospace' | 'other';
+}
+/**
+ * Normalize a `fontFamilies` prop (mix of strings and FontOption
+ * objects) into a uniform `FontOption[]`. Returns `undefined` for
+ * `undefined` input so callers fall back to their built-in defaults.
+ * Strings expand into the `'other'` group with no CSS fallback chain.
+ */
+declare function normalizeFontFamilies(fontFamilies: ReadonlyArray<string | FontOption> | undefined): FontOption[] | undefined;
+
+export { type FontOption, normalizeFontFamilies };

package/dist/utils/fontOptions.js

@@ -0,0 +1 @@
+'use strict';require('../chunk-DC7S76ZX.js');function a(o){if(o===void 0)return;let t=o.map(n=>typeof n=="string"?{name:n,fontFamily:n,category:"other"}:n);if(r()){let n=new Set,i=new Set;for(let e of t)i.has(e.name)&&!n.has(e.name)&&(console.warn(`[DocxEditor] Duplicate font name in fontFamilies: "${e.name}"`),n.add(e.name)),i.add(e.name);}return t}function r(){return typeof process<"u"&&process.env?.NODE_ENV!=="production"}exports.normalizeFontFamilies=a;

package/dist/utils/fontOptions.mjs

@@ -0,0 +1 @@
+import'../chunk-QYUPLKLP.mjs';function a(o){if(o===void 0)return;let t=o.map(n=>typeof n=="string"?{name:n,fontFamily:n,category:"other"}:n);if(r()){let n=new Set,i=new Set;for(let e of t)i.has(e.name)&&!n.has(e.name)&&(console.warn(`[DocxEditor] Duplicate font name in fontFamilies: "${e.name}"`),n.add(e.name)),i.add(e.name);}return t}function r(){return typeof process<"u"&&process.env?.NODE_ENV!=="production"}export{a as normalizeFontFamilies};

package/dist/utils/headingCollector.d.mts

@@ -0,0 +1,32 @@
+/**
+ * @packageDocumentation
+ * @public
+ */
+import { Node } from 'prosemirror-model';
+
+/**
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Information about a heading found in the document.
+ */
+interface HeadingInfo {
+    /** The text content of the heading */
+    text: string;
+    /** Outline level (0 = Heading 1, 1 = Heading 2, etc.) */
+    level: number;
+    /** ProseMirror document position of the paragraph node */
+    pmPos: number;
+}
+/**
+ * Collect all headings from a ProseMirror document.
+ *
+ * Detection logic:
+ * 1. Check `outlineLevel` attr (set by OOXML parsing or style resolution)
+ * 2. Fallback to `styleId` matching /^[Hh]eading(\d)$/
+ */
+declare function collectHeadings(doc: Node): HeadingInfo[];
+
+export { type HeadingInfo, collectHeadings };

package/dist/utils/headingCollector.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @packageDocumentation
+ * @public
+ */
+import { Node } from 'prosemirror-model';
+
+/**
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * Information about a heading found in the document.
+ */
+interface HeadingInfo {
+    /** The text content of the heading */
+    text: string;
+    /** Outline level (0 = Heading 1, 1 = Heading 2, etc.) */
+    level: number;
+    /** ProseMirror document position of the paragraph node */
+    pmPos: number;
+}
+/**
+ * Collect all headings from a ProseMirror document.
+ *
+ * Detection logic:
+ * 1. Check `outlineLevel` attr (set by OOXML parsing or style resolution)
+ * 2. Fallback to `styleId` matching /^[Hh]eading(\d)$/
+ */
+declare function collectHeadings(doc: Node): HeadingInfo[];
+
+export { type HeadingInfo, collectHeadings };

package/dist/utils/headingCollector.js

@@ -0,0 +1 @@
+'use strict';var chunkMZ7LW5CH_js=require('../chunk-MZ7LW5CH.js');require('../chunk-DC7S76ZX.js');Object.defineProperty(exports,"collectHeadings",{enumerable:true,get:function(){return chunkMZ7LW5CH_js.a}});

package/dist/utils/headingCollector.mjs

@@ -0,0 +1 @@
+export{a as collectHeadings}from'../chunk-OZMNIX6U.mjs';import'../chunk-QYUPLKLP.mjs';

package/dist/utils/highlightColors.d.mts

@@ -0,0 +1,14 @@
+/**
+ * OOXML highlight color name <-> hex mapping. Used by both adapter
+ * toolbars when serialising highlight selections to the
+ * `w:highlight` attribute (which only accepts named colors).
+ *
+ * Lifted from packages/react/src/components/toolbarUtils.ts so both
+ * sides share the same canonical table.
+ * @packageDocumentation
+ * @public
+ */
+declare const HIGHLIGHT_HEX_TO_NAME: Record<string, string>;
+declare function mapHexToHighlightName(hex: string): string | null;
+
+export { HIGHLIGHT_HEX_TO_NAME, mapHexToHighlightName };

package/dist/utils/highlightColors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * OOXML highlight color name <-> hex mapping. Used by both adapter
+ * toolbars when serialising highlight selections to the
+ * `w:highlight` attribute (which only accepts named colors).
+ *
+ * Lifted from packages/react/src/components/toolbarUtils.ts so both
+ * sides share the same canonical table.
+ * @packageDocumentation
+ * @public
+ */
+declare const HIGHLIGHT_HEX_TO_NAME: Record<string, string>;
+declare function mapHexToHighlightName(hex: string): string | null;
+
+export { HIGHLIGHT_HEX_TO_NAME, mapHexToHighlightName };

package/dist/utils/highlightColors.js

@@ -0,0 +1 @@
+'use strict';require('../chunk-DC7S76ZX.js');var F={FFFF00:"yellow","00FF00":"green","00FFFF":"cyan",FF00FF:"magenta","0000FF":"blue",FF0000:"red","00008B":"darkBlue","008080":"darkCyan","008000":"darkGreen",800080:"darkMagenta","8B0000":"darkRed",808e3:"darkYellow",808080:"darkGray",C0C0C0:"lightGray","000000":"black",FFFFFF:"white"};function a(e){let r=e.replace(/^#/,"").toUpperCase();return F[r]||null}exports.HIGHLIGHT_HEX_TO_NAME=F;exports.mapHexToHighlightName=a;

package/dist/utils/highlightColors.mjs

@@ -0,0 +1 @@
+import'../chunk-QYUPLKLP.mjs';var F={FFFF00:"yellow","00FF00":"green","00FFFF":"cyan",FF00FF:"magenta","0000FF":"blue",FF0000:"red","00008B":"darkBlue","008080":"darkCyan","008000":"darkGreen",800080:"darkMagenta","8B0000":"darkRed",808e3:"darkYellow",808080:"darkGray",C0C0C0:"lightGray","000000":"black",FFFFFF:"white"};function a(e){let r=e.replace(/^#/,"").toUpperCase();return F[r]||null}export{F as HIGHLIGHT_HEX_TO_NAME,a as mapHexToHighlightName};