@docx-editor.dev/core 0.0.1 → 2.0.1

package/dist/chunk-ZT55Q52J.cjs

@@ -0,0 +1,2 @@
+'use strict';var c="http://schemas.microsoft.com/office/word/2012/wordml";function R(e){return `${e.kind}-${e.id}`}function v(e){let o=[],t=n=>{if(n.kind==="textValue"){o.push(n.value);return}for(let r of n.children)t(r);};for(let n of e.blocks)t(n);return o.join("")}function w(e){if(e.initials&&e.initials.trim().length>0)return e.initials.trim();let o=e.author.trim().split(/\s+/).filter(Boolean);return o.length===0?"?":o.slice(0,2).map(t=>t[0].toUpperCase()).join("")}function I(e){let o=new Map,t=(n,r)=>{if(!(n.kind==="textValue"||r>64)){if(n.kind==="paragraph"){o.has(n.id)||o.set(n.id,o.size);return}for(let i of n.children)t(i,r+1);}};return t(e.root,0),o}function s(e){return e.kind==="revision"?e.ranges:e.range?[e.range]:[]}function l(e){return s(e)[0]??null}function x(e,o){let t=l(e);if(!t)return Number.MAX_SAFE_INTEGER;let n=o.get(t.start.paragraphId);return n===void 0?Number.MAX_SAFE_INTEGER:n*1e6+Math.min(t.start.offset,999999)}function u(e,o){let t=o.get(e.start.paragraphId),n=o.get(e.end.paragraphId);return t===void 0||n===void 0?Number.MAX_SAFE_INTEGER:(n-t)*1e6+(e.end.offset-e.start.offset)}function y(e,o,t){let n=t.get(o.paragraphId),r=t.get(e.start.paragraphId),i=t.get(e.end.paragraphId);return !(n===void 0||r===void 0||i===void 0||n<r||n>i||n===r&&o.offset<e.start.offset||n===i&&o.offset>e.end.offset)}function f(e,o,t){let n=null;for(let r of s(e)){if(!y(r,o,t))continue;let i=u(r,t);(n===null||i<n)&&(n=i);}return n}var d={comment:0,custom:1,revision:2};function g(e,o,t){let n=[];for(let r of e){let i=f(r,o,t);i!==null&&n.push({item:r,width:i});}return n.sort((r,i)=>r.width!==i.width?r.width-i.width:r.item.kind!==i.item.kind?d[r.item.kind]-d[i.item.kind]:0).map(r=>r.item)}function h(e,o,t){let r=g(e,o,t).filter(i=>!(i.kind==="comment"&&i.resolved))[0];return r?r.kind==="comment"?m(e,r):r:null}function b(e,o){return m(e,o)}function m(e,o){let t=new Map,n=new Map;for(let a of e)a.kind==="comment"?t.set(a.id,a):a.kind==="revision"&&n.set(a.id,a);let r=new Set([o.id]),i=o;for(;i.parentId!==void 0;){let a=t.get(i.parentId);if(!a||r.has(a.id))break;r.add(a.id),i=a;}if(i.parentRevisionId!==void 0){let a=n.get(i.parentRevisionId);if(a)return a}return i}function P(e,o){let t=new Map;for(let n of e.pages)for(let r of o(n))t.has(r.paragraphId)||t.set(r.paragraphId,{pageIndex:n.index,contentY:n.contentBox.y,fragmentY:r.box.y,...r.lines?{lines:r.lines}:{}});return t}function k(e,o){let t=l(e);if(!t)return null;let n=o.get(t.start.paragraphId);if(!n)return null;let r=n.lines?.find(i=>t.start.offset<i.range.end);return {pageIndex:n.pageIndex,y:n.contentY+(r?r.box.y:n.fragmentY)}}
+exports.a=c;exports.b=R;exports.c=v;exports.d=w;exports.e=I;exports.f=s;exports.g=l;exports.h=x;exports.i=g;exports.j=h;exports.k=b;exports.l=P;exports.m=k;

package/dist/chunk-ZUALAR4M.js

@@ -0,0 +1,2 @@
+var c="http://schemas.microsoft.com/office/word/2012/wordml";function R(e){return `${e.kind}-${e.id}`}function v(e){let o=[],t=n=>{if(n.kind==="textValue"){o.push(n.value);return}for(let r of n.children)t(r);};for(let n of e.blocks)t(n);return o.join("")}function w(e){if(e.initials&&e.initials.trim().length>0)return e.initials.trim();let o=e.author.trim().split(/\s+/).filter(Boolean);return o.length===0?"?":o.slice(0,2).map(t=>t[0].toUpperCase()).join("")}function I(e){let o=new Map,t=(n,r)=>{if(!(n.kind==="textValue"||r>64)){if(n.kind==="paragraph"){o.has(n.id)||o.set(n.id,o.size);return}for(let i of n.children)t(i,r+1);}};return t(e.root,0),o}function s(e){return e.kind==="revision"?e.ranges:e.range?[e.range]:[]}function l(e){return s(e)[0]??null}function x(e,o){let t=l(e);if(!t)return Number.MAX_SAFE_INTEGER;let n=o.get(t.start.paragraphId);return n===void 0?Number.MAX_SAFE_INTEGER:n*1e6+Math.min(t.start.offset,999999)}function u(e,o){let t=o.get(e.start.paragraphId),n=o.get(e.end.paragraphId);return t===void 0||n===void 0?Number.MAX_SAFE_INTEGER:(n-t)*1e6+(e.end.offset-e.start.offset)}function y(e,o,t){let n=t.get(o.paragraphId),r=t.get(e.start.paragraphId),i=t.get(e.end.paragraphId);return !(n===void 0||r===void 0||i===void 0||n<r||n>i||n===r&&o.offset<e.start.offset||n===i&&o.offset>e.end.offset)}function f(e,o,t){let n=null;for(let r of s(e)){if(!y(r,o,t))continue;let i=u(r,t);(n===null||i<n)&&(n=i);}return n}var d={comment:0,custom:1,revision:2};function g(e,o,t){let n=[];for(let r of e){let i=f(r,o,t);i!==null&&n.push({item:r,width:i});}return n.sort((r,i)=>r.width!==i.width?r.width-i.width:r.item.kind!==i.item.kind?d[r.item.kind]-d[i.item.kind]:0).map(r=>r.item)}function h(e,o,t){let r=g(e,o,t).filter(i=>!(i.kind==="comment"&&i.resolved))[0];return r?r.kind==="comment"?m(e,r):r:null}function b(e,o){return m(e,o)}function m(e,o){let t=new Map,n=new Map;for(let a of e)a.kind==="comment"?t.set(a.id,a):a.kind==="revision"&&n.set(a.id,a);let r=new Set([o.id]),i=o;for(;i.parentId!==void 0;){let a=t.get(i.parentId);if(!a||r.has(a.id))break;r.add(a.id),i=a;}if(i.parentRevisionId!==void 0){let a=n.get(i.parentRevisionId);if(a)return a}return i}function P(e,o){let t=new Map;for(let n of e.pages)for(let r of o(n))t.has(r.paragraphId)||t.set(r.paragraphId,{pageIndex:n.index,contentY:n.contentBox.y,fragmentY:r.box.y,...r.lines?{lines:r.lines}:{}});return t}function k(e,o){let t=l(e);if(!t)return null;let n=o.get(t.start.paragraphId);if(!n)return null;let r=n.lines?.find(i=>t.start.offset<i.range.end);return {pageIndex:n.pageIndex,y:n.contentY+(r?r.box.y:n.fragmentY)}}
+export{c as a,R as b,v as c,w as d,I as e,s as f,l as g,x as h,g as i,h as j,b as k,P as l,k as m};

package/dist/content-control-walk-CbTqHq6O.d.cts

@@ -0,0 +1,56 @@
+import { O as OoxmlNode, a as OoxmlElement, b as OoxmlContentControlNode, c as OoxmlGenericElementNode, d as OoxmlContentControlContentNode } from './ooxml-tree-BU0e3DVi.cjs';
+
+/** Nested content-control wrappers deeper than this stop flattening; content stays preserved. */
+declare const MAX_CONTENT_CONTROL_NESTING = 32;
+type ContentControlLike = OoxmlContentControlNode | OoxmlGenericElementNode;
+type ContentControlContentLike = OoxmlContentControlContentNode | OoxmlGenericElementNode;
+/**
+ * Block or inline structured-document-tag wrapper — typed or generic during migration.
+ *
+ * Generic fallback requires the WordprocessingML namespace so foreign-namespace
+ * `<x:sdt>` elements stay opaque wrappers and are never treated as Word controls.
+ */
+declare function isContentControl(node: OoxmlNode): node is ContentControlLike;
+/**
+ * True when `node` is the control's content container (`w:sdtContent`).
+ *
+ * Generic `sdtContent` requires the WML namespace — same foreign-namespace rule as
+ * {@link isContentControl}.
+ */
+declare function isContentControlContent(node: OoxmlNode): node is ContentControlContentLike;
+/** Children of the first `w:sdtContent` under a control, or null when absent or not a control. */
+declare function contentControlContentOf(node: OoxmlNode): readonly OoxmlNode[] | null;
+/**
+ * Children of every `w:sdtContent` under a control, in document order.
+ *
+ * Does not recurse into nested controls — callers that flatten blocks or inline runs do that
+ * with their own depth counter against {@link MAX_CONTENT_CONTROL_NESTING}.
+ */
+declare function contentControlContentChildren(control: OoxmlNode): readonly OoxmlNode[];
+/**
+ * Collect paragraph and table blocks from a sibling list, flattening through content-control
+ * wrappers up to {@link MAX_CONTENT_CONTROL_NESTING}.
+ *
+ * `accept` filters which typed blocks are kept (e.g. skip revision-removed paragraphs). When
+ * nesting exceeds the bound the wrapper is skipped entirely — same fail-closed rule as the
+ * historical `storyBlocks` walk.
+ */
+declare function collectFlowBlocks(children: readonly OoxmlNode[], depth?: number, accept?: (block: OoxmlElement) => boolean): OoxmlElement[];
+/**
+ * Story blocks in document order, flattening block-level content controls — same shape as
+ * layout's `storyBlocks` and store `bodyBlocks`.
+ */
+declare function walkStoryBlocks(children: readonly OoxmlNode[], depth: number, visit: (block: OoxmlElement) => void): void;
+/**
+ * Every story paragraph in reading order — body, table cells, and flattened block controls.
+ */
+declare function walkAllStoryParagraphs(children: readonly OoxmlNode[], sdtDepth: number, visit: (paragraph: OoxmlElement) => void): void;
+/**
+ * Paragraph-level inline sequence — runs, hyperlinks, and inline content controls in order.
+ *
+ * `visit` receives each direct `w:r` and any other inline node the caller treats as opaque
+ * (bookmarks, drawings, …). Hyperlinks and content controls are descended transparently.
+ */
+declare function walkParagraphInline(children: readonly OoxmlNode[], depth: number, visit: (child: OoxmlNode) => void): void;
+
+export { MAX_CONTENT_CONTROL_NESTING as M, contentControlContentChildren as a, isContentControlContent as b, collectFlowBlocks as c, contentControlContentOf as d, walkParagraphInline as e, walkStoryBlocks as f, isContentControl as i, walkAllStoryParagraphs as w };

package/dist/content-control-walk-D06GijR0.d.ts

@@ -0,0 +1,56 @@
+import { O as OoxmlNode, a as OoxmlElement, b as OoxmlContentControlNode, c as OoxmlGenericElementNode, d as OoxmlContentControlContentNode } from './ooxml-tree-BU0e3DVi.js';
+
+/** Nested content-control wrappers deeper than this stop flattening; content stays preserved. */
+declare const MAX_CONTENT_CONTROL_NESTING = 32;
+type ContentControlLike = OoxmlContentControlNode | OoxmlGenericElementNode;
+type ContentControlContentLike = OoxmlContentControlContentNode | OoxmlGenericElementNode;
+/**
+ * Block or inline structured-document-tag wrapper — typed or generic during migration.
+ *
+ * Generic fallback requires the WordprocessingML namespace so foreign-namespace
+ * `<x:sdt>` elements stay opaque wrappers and are never treated as Word controls.
+ */
+declare function isContentControl(node: OoxmlNode): node is ContentControlLike;
+/**
+ * True when `node` is the control's content container (`w:sdtContent`).
+ *
+ * Generic `sdtContent` requires the WML namespace — same foreign-namespace rule as
+ * {@link isContentControl}.
+ */
+declare function isContentControlContent(node: OoxmlNode): node is ContentControlContentLike;
+/** Children of the first `w:sdtContent` under a control, or null when absent or not a control. */
+declare function contentControlContentOf(node: OoxmlNode): readonly OoxmlNode[] | null;
+/**
+ * Children of every `w:sdtContent` under a control, in document order.
+ *
+ * Does not recurse into nested controls — callers that flatten blocks or inline runs do that
+ * with their own depth counter against {@link MAX_CONTENT_CONTROL_NESTING}.
+ */
+declare function contentControlContentChildren(control: OoxmlNode): readonly OoxmlNode[];
+/**
+ * Collect paragraph and table blocks from a sibling list, flattening through content-control
+ * wrappers up to {@link MAX_CONTENT_CONTROL_NESTING}.
+ *
+ * `accept` filters which typed blocks are kept (e.g. skip revision-removed paragraphs). When
+ * nesting exceeds the bound the wrapper is skipped entirely — same fail-closed rule as the
+ * historical `storyBlocks` walk.
+ */
+declare function collectFlowBlocks(children: readonly OoxmlNode[], depth?: number, accept?: (block: OoxmlElement) => boolean): OoxmlElement[];
+/**
+ * Story blocks in document order, flattening block-level content controls — same shape as
+ * layout's `storyBlocks` and store `bodyBlocks`.
+ */
+declare function walkStoryBlocks(children: readonly OoxmlNode[], depth: number, visit: (block: OoxmlElement) => void): void;
+/**
+ * Every story paragraph in reading order — body, table cells, and flattened block controls.
+ */
+declare function walkAllStoryParagraphs(children: readonly OoxmlNode[], sdtDepth: number, visit: (paragraph: OoxmlElement) => void): void;
+/**
+ * Paragraph-level inline sequence — runs, hyperlinks, and inline content controls in order.
+ *
+ * `visit` receives each direct `w:r` and any other inline node the caller treats as opaque
+ * (bookmarks, drawings, …). Hyperlinks and content controls are descended transparently.
+ */
+declare function walkParagraphInline(children: readonly OoxmlNode[], depth: number, visit: (child: OoxmlNode) => void): void;
+
+export { MAX_CONTENT_CONTROL_NESTING as M, contentControlContentChildren as a, isContentControlContent as b, collectFlowBlocks as c, contentControlContentOf as d, walkParagraphInline as e, walkStoryBlocks as f, isContentControl as i, walkAllStoryParagraphs as w };

package/dist/contracts/document.cjs

@@ -0,0 +1 @@
+'use strict';

package/dist/contracts/document.d.cts

@@ -0,0 +1,246 @@
+import { DocxDocument, ExecResult, ContentControlType, DocTarget, RunFormatting, Extent, ContainerRef, ContentControlFilter, DocRange, Revision, DocComment, StyleDefinitions } from './types.cjs';
+export { Block, ColorValue, ContentControl, DocAnchor, DocAnchorRange, DocLocation, DocumentBody, ExecErrorCode, HeaderFooterSet, IndentFormatting, Paragraph, RevisionType, Section, SectionProperties, StyleDefinition, Table, Theme, ThemeColorScheme } from './types.cjs';
+
+/**
+ * `@docx-editor.dev/core/contracts/document` — the document-level edit and query vocabulary.
+ *
+ * The subset that means something without a live editor: what an automation host or an LLM tool
+ * can ask for and change.
+ *
+ * A CONTRACT module, not a barrel. `contracts/editor` builds the `Editor` command and query
+ * surfaces on top of these, so they cannot live in the package root: the root re-exports
+ * runtime from `../editor`, and a contract importing the root would invert the dependency —
+ * safe today only because that import is type-only, and one accidental value import away from
+ * pulling the painted engine into a server bundle.
+ *
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * The document-executable edit vocabulary.
+ *
+ * An interface rather than a closed union so extensions can widen it by
+ * declaration merging. A sealed union cannot be extended by a plugin, and the
+ * runtime dispatch is already registry-backed.
+ */
+interface DocEdits {
+    insertText: {
+        target: DocTarget;
+        text: string;
+    };
+    replaceText: {
+        target: DocTarget;
+        text: string;
+    };
+    deleteText: {
+        target: DocTarget;
+    };
+    applyFormatting: {
+        target: DocTarget;
+        marks: RunFormatting;
+    };
+    setParagraphStyle: {
+        target: DocTarget;
+        styleId: string;
+    };
+    insertTable: {
+        target: DocTarget;
+        rows: number;
+        cols: number;
+    };
+    insertImage: {
+        target: DocTarget;
+        data: Uint8Array;
+        extent?: Extent;
+    };
+    insertHyperlink: {
+        target: DocTarget;
+        href: string;
+        text?: string;
+    };
+    removeHyperlink: {
+        target: DocTarget;
+    };
+    insertBreak: {
+        target: DocTarget;
+        kind: 'page' | 'column' | 'line' | 'section';
+    };
+    /**
+     * Word's Increase/Decrease Indent.
+     *
+     * A numbered or bulleted paragraph changes LEVEL, so its marker re-resolves from the
+     * numbering definition — a bullet becomes a hollow circle, a `1.` becomes an `a.`.
+     * Every other paragraph moves its left indent by one default tab stop.
+     */
+    adjustIndent: {
+        target: DocTarget;
+        direction: 'increase' | 'decrease';
+    };
+    /**
+     * Word's Bullets and Numbering.
+     *
+     * Turns the selection into a list, or takes it out of one when it already is. The
+     * definition is created on first use, `numbering.xml` included.
+     */
+    toggleList: {
+        target: DocTarget;
+        kind: 'bullet' | 'ordered';
+    };
+    splitParagraph: {
+        target: DocTarget;
+    };
+    mergeParagraphs: {
+        target: DocTarget;
+    };
+    setVariable: {
+        name: string;
+        value: string;
+    };
+    applyVariables: {
+        values: Record<string, string>;
+    };
+    /**
+     * Authored family. `author` is required: tracked-ness is verb identity, not a
+     * boolean flag, so there is no global trackChanges toggle to forget.
+     */
+    proposeReplacement: {
+        target: DocTarget;
+        replaceWith: string;
+        author: string;
+    };
+    proposeInsertion: {
+        target: DocTarget;
+        text: string;
+        author: string;
+    };
+    proposeDeletion: {
+        target: DocTarget;
+        author: string;
+    };
+    addComment: {
+        target: DocTarget;
+        text: string;
+        author: string;
+    };
+    replyComment: {
+        commentId: string;
+        text: string;
+        author: string;
+    };
+    resolveComment: {
+        commentId: string;
+    };
+    acceptRevision: {
+        id: number;
+        part?: 'body' | 'footnote' | 'endnote';
+        noteId?: number;
+    };
+    rejectRevision: {
+        id: number;
+        part?: 'body' | 'footnote' | 'endnote';
+        noteId?: number;
+    };
+    acceptAllRevisions: Record<never, never>;
+    rejectAllRevisions: Record<never, never>;
+    setContentControlValue: {
+        target: DocTarget;
+        value: string;
+    };
+    removeContentControl: {
+        target: DocTarget;
+    };
+    addRepeatingSectionItem: {
+        target: DocTarget;
+        index?: number;
+    };
+    removeRepeatingSectionItem: {
+        target: DocTarget;
+        index: number;
+    };
+}
+/**
+ * One edit, as a discriminated union derived from {@link DocEdits}.
+ *
+ * Adding a key to `DocEdits` — including by declaration merging from a plugin — widens this
+ * automatically, so the union never drifts from the vocabulary it is built out of.
+ */
+type DocEdit = {
+    [K in keyof DocEdits]: {
+        type: K;
+    } & DocEdits[K];
+}[keyof DocEdits];
+/**
+ * What applying a batch of edits produced: the new document, and a per-edit verdict.
+ *
+ * `results` is positionally aligned with the input, so an edit that failed is identified by its
+ * index rather than by anything the caller has to correlate.
+ */
+interface ApplyResult {
+    doc: DocxDocument;
+    /** One per edit, positionally aligned with the input. */
+    results: ExecResult[];
+}
+/**
+ * The document-readable query vocabulary, keyed identically to {@link DocQueryResults}.
+ *
+ * An interface rather than a closed union for the same reason {@link DocEdits} is: an extension
+ * widens it by declaration merging, and the runtime dispatch is registry-backed.
+ */
+interface DocQueries {
+    paragraphs: {
+        container?: ContainerRef;
+    };
+    findText: {
+        text: string;
+        container?: ContainerRef;
+    };
+    contentControls: {
+        filter?: ContentControlFilter;
+    };
+    revisions: {
+        part?: 'body' | 'footnote' | 'endnote';
+    };
+    comments: {
+        resolved?: boolean;
+    };
+    styles: Record<never, never>;
+    variables: Record<never, never>;
+}
+/** One query, as a discriminated union derived from {@link DocQueries}. */
+type DocQuery = {
+    [K in keyof DocQueries]: {
+        type: K;
+    } & DocQueries[K];
+}[keyof DocQueries];
+/** What each query returns. Keyed identically to `DocQueries`. */
+interface DocQueryResults {
+    paragraphs: readonly ParagraphSummary[];
+    findText: readonly DocRange[];
+    contentControls: readonly ContentControlSummary[];
+    revisions: readonly Revision[];
+    comments: readonly DocComment[];
+    styles: StyleDefinitions;
+    variables: Readonly<Record<string, string>>;
+}
+/**
+ * A paragraph reduced to what a listing needs: its stable handle, its text, and its style.
+ *
+ * `paraId` is what a follow-up edit addresses, so a summary without one names a paragraph the
+ * file gave no `w14:paraId` and that a `DocAnchor` cannot reach.
+ */
+interface ParagraphSummary {
+    readonly paraId?: string;
+    readonly text: string;
+    readonly styleId?: string;
+}
+/** A content control reduced to what a listing needs: its identity, kind, and lock state. */
+interface ContentControlSummary {
+    readonly id: string;
+    readonly tag?: string;
+    readonly alias?: string;
+    readonly controlType: ContentControlType;
+    readonly locked?: boolean;
+}
+
+export { type ApplyResult, ContainerRef, ContentControlFilter, type ContentControlSummary, ContentControlType, DocComment, type DocEdit, type DocEdits, type DocQueries, type DocQuery, type DocQueryResults, DocRange, DocTarget, DocxDocument, ExecResult, Extent, type ParagraphSummary, Revision, RunFormatting, StyleDefinitions };

package/dist/contracts/document.d.ts

@@ -0,0 +1,246 @@
+import { DocxDocument, ExecResult, ContentControlType, DocTarget, RunFormatting, Extent, ContainerRef, ContentControlFilter, DocRange, Revision, DocComment, StyleDefinitions } from './types.js';
+export { Block, ColorValue, ContentControl, DocAnchor, DocAnchorRange, DocLocation, DocumentBody, ExecErrorCode, HeaderFooterSet, IndentFormatting, Paragraph, RevisionType, Section, SectionProperties, StyleDefinition, Table, Theme, ThemeColorScheme } from './types.js';
+
+/**
+ * `@docx-editor.dev/core/contracts/document` — the document-level edit and query vocabulary.
+ *
+ * The subset that means something without a live editor: what an automation host or an LLM tool
+ * can ask for and change.
+ *
+ * A CONTRACT module, not a barrel. `contracts/editor` builds the `Editor` command and query
+ * surfaces on top of these, so they cannot live in the package root: the root re-exports
+ * runtime from `../editor`, and a contract importing the root would invert the dependency —
+ * safe today only because that import is type-only, and one accidental value import away from
+ * pulling the painted engine into a server bundle.
+ *
+ * @packageDocumentation
+ * @public
+ */
+
+/**
+ * The document-executable edit vocabulary.
+ *
+ * An interface rather than a closed union so extensions can widen it by
+ * declaration merging. A sealed union cannot be extended by a plugin, and the
+ * runtime dispatch is already registry-backed.
+ */
+interface DocEdits {
+    insertText: {
+        target: DocTarget;
+        text: string;
+    };
+    replaceText: {
+        target: DocTarget;
+        text: string;
+    };
+    deleteText: {
+        target: DocTarget;
+    };
+    applyFormatting: {
+        target: DocTarget;
+        marks: RunFormatting;
+    };
+    setParagraphStyle: {
+        target: DocTarget;
+        styleId: string;
+    };
+    insertTable: {
+        target: DocTarget;
+        rows: number;
+        cols: number;
+    };
+    insertImage: {
+        target: DocTarget;
+        data: Uint8Array;
+        extent?: Extent;
+    };
+    insertHyperlink: {
+        target: DocTarget;
+        href: string;
+        text?: string;
+    };
+    removeHyperlink: {
+        target: DocTarget;
+    };
+    insertBreak: {
+        target: DocTarget;
+        kind: 'page' | 'column' | 'line' | 'section';
+    };
+    /**
+     * Word's Increase/Decrease Indent.
+     *
+     * A numbered or bulleted paragraph changes LEVEL, so its marker re-resolves from the
+     * numbering definition — a bullet becomes a hollow circle, a `1.` becomes an `a.`.
+     * Every other paragraph moves its left indent by one default tab stop.
+     */
+    adjustIndent: {
+        target: DocTarget;
+        direction: 'increase' | 'decrease';
+    };
+    /**
+     * Word's Bullets and Numbering.
+     *
+     * Turns the selection into a list, or takes it out of one when it already is. The
+     * definition is created on first use, `numbering.xml` included.
+     */
+    toggleList: {
+        target: DocTarget;
+        kind: 'bullet' | 'ordered';
+    };
+    splitParagraph: {
+        target: DocTarget;
+    };
+    mergeParagraphs: {
+        target: DocTarget;
+    };
+    setVariable: {
+        name: string;
+        value: string;
+    };
+    applyVariables: {
+        values: Record<string, string>;
+    };
+    /**
+     * Authored family. `author` is required: tracked-ness is verb identity, not a
+     * boolean flag, so there is no global trackChanges toggle to forget.
+     */
+    proposeReplacement: {
+        target: DocTarget;
+        replaceWith: string;
+        author: string;
+    };
+    proposeInsertion: {
+        target: DocTarget;
+        text: string;
+        author: string;
+    };
+    proposeDeletion: {
+        target: DocTarget;
+        author: string;
+    };
+    addComment: {
+        target: DocTarget;
+        text: string;
+        author: string;
+    };
+    replyComment: {
+        commentId: string;
+        text: string;
+        author: string;
+    };
+    resolveComment: {
+        commentId: string;
+    };
+    acceptRevision: {
+        id: number;
+        part?: 'body' | 'footnote' | 'endnote';
+        noteId?: number;
+    };
+    rejectRevision: {
+        id: number;
+        part?: 'body' | 'footnote' | 'endnote';
+        noteId?: number;
+    };
+    acceptAllRevisions: Record<never, never>;
+    rejectAllRevisions: Record<never, never>;
+    setContentControlValue: {
+        target: DocTarget;
+        value: string;
+    };
+    removeContentControl: {
+        target: DocTarget;
+    };
+    addRepeatingSectionItem: {
+        target: DocTarget;
+        index?: number;
+    };
+    removeRepeatingSectionItem: {
+        target: DocTarget;
+        index: number;
+    };
+}
+/**
+ * One edit, as a discriminated union derived from {@link DocEdits}.
+ *
+ * Adding a key to `DocEdits` — including by declaration merging from a plugin — widens this
+ * automatically, so the union never drifts from the vocabulary it is built out of.
+ */
+type DocEdit = {
+    [K in keyof DocEdits]: {
+        type: K;
+    } & DocEdits[K];
+}[keyof DocEdits];
+/**
+ * What applying a batch of edits produced: the new document, and a per-edit verdict.
+ *
+ * `results` is positionally aligned with the input, so an edit that failed is identified by its
+ * index rather than by anything the caller has to correlate.
+ */
+interface ApplyResult {
+    doc: DocxDocument;
+    /** One per edit, positionally aligned with the input. */
+    results: ExecResult[];
+}
+/**
+ * The document-readable query vocabulary, keyed identically to {@link DocQueryResults}.
+ *
+ * An interface rather than a closed union for the same reason {@link DocEdits} is: an extension
+ * widens it by declaration merging, and the runtime dispatch is registry-backed.
+ */
+interface DocQueries {
+    paragraphs: {
+        container?: ContainerRef;
+    };
+    findText: {
+        text: string;
+        container?: ContainerRef;
+    };
+    contentControls: {
+        filter?: ContentControlFilter;
+    };
+    revisions: {
+        part?: 'body' | 'footnote' | 'endnote';
+    };
+    comments: {
+        resolved?: boolean;
+    };
+    styles: Record<never, never>;
+    variables: Record<never, never>;
+}
+/** One query, as a discriminated union derived from {@link DocQueries}. */
+type DocQuery = {
+    [K in keyof DocQueries]: {
+        type: K;
+    } & DocQueries[K];
+}[keyof DocQueries];
+/** What each query returns. Keyed identically to `DocQueries`. */
+interface DocQueryResults {
+    paragraphs: readonly ParagraphSummary[];
+    findText: readonly DocRange[];
+    contentControls: readonly ContentControlSummary[];
+    revisions: readonly Revision[];
+    comments: readonly DocComment[];
+    styles: StyleDefinitions;
+    variables: Readonly<Record<string, string>>;
+}
+/**
+ * A paragraph reduced to what a listing needs: its stable handle, its text, and its style.
+ *
+ * `paraId` is what a follow-up edit addresses, so a summary without one names a paragraph the
+ * file gave no `w14:paraId` and that a `DocAnchor` cannot reach.
+ */
+interface ParagraphSummary {
+    readonly paraId?: string;
+    readonly text: string;
+    readonly styleId?: string;
+}
+/** A content control reduced to what a listing needs: its identity, kind, and lock state. */
+interface ContentControlSummary {
+    readonly id: string;
+    readonly tag?: string;
+    readonly alias?: string;
+    readonly controlType: ContentControlType;
+    readonly locked?: boolean;
+}
+
+export { type ApplyResult, ContainerRef, ContentControlFilter, type ContentControlSummary, ContentControlType, DocComment, type DocEdit, type DocEdits, type DocQueries, type DocQuery, type DocQueryResults, DocRange, DocTarget, DocxDocument, ExecResult, Extent, type ParagraphSummary, Revision, RunFormatting, StyleDefinitions };

package/dist/contracts/editor.cjs

@@ -0,0 +1 @@
+'use strict';var chunkHBL3NNH5_cjs=require('../chunk-HBL3NNH5.cjs');Object.defineProperty(exports,"EditorFontError",{enumerable:true,get:function(){return chunkHBL3NNH5_cjs.a}});

package/dist/contracts/editor.d.cts

@@ -0,0 +1,11 @@
+export { ContentControlSummary, DocEdits, DocQueries, DocQueryResults, ParagraphSummary } from './document.cjs';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from '../review-support-DS8DYX2a.cjs';
+export { A as AuthoredNoteNumbering, C as CanResult, p as DocumentChange, q as DocumentEditingMode, r as DocumentHandle, D as DocumentSource, l as Editor, a as EditorCommand, t as EditorCommandShape, u as EditorCommands, w as EditorError, x as EditorEvents, E as EditorFontError, y as EditorFontErrorCode, z as EditorHeaderFooterCommands, B as EditorNoteCommands, G as EditorPosition, H as EditorQueries, J as EditorQuery, K as EditorQueryResults, L as EditorScope, M as EditorSelection, N as EditorSnapshot, F as FontConfiguration, k as FontFaceRequest, i as FontSource, j as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, b as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, Z as NotePropertiesSide, _ as NotePropertiesState, $ as PageSetup, a0 as ResolvedNoteNumbering, a1 as ReviewCommentPlacement, a2 as ReviewCustomPlacement, a3 as ReviewItemPlacement, a4 as ReviewItemPlacementBase, a5 as ReviewItemQuery, a6 as ReviewRevisionPlacement, S as SelectedImageState, a7 as SemanticIdentity, a8 as SemanticTarget, T as TableBorderEdgeTarget, m as TableBorderSpec, n as TableBorderStyle, a9 as TableBorderTarget, aa as TableCellVerticalAlignment, ab as TableColumnDividerResizeTarget, ac as TableColumnOccurrenceTarget, o as TableContext, ad as TableRightEdgeResizeTarget, ae as TableRowOccurrenceTarget, af as TextMatch, V as ViewScope } from '../editor-D0UDock4.cjs';
+export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-D-Dszxrn.cjs';
+export { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, NumberingRef, PageMargins, Paragraph, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark } from './types.cjs';
+export { f as DrawingHorizontalReferenceFrame, c as DrawingKind, e as DrawingLocks, d as DrawingPositionInput, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, R as RevisionAddress } from '../tree-op-types-DMiW6nIH.cjs';
+export { I as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, a as VectorImageMime } from '../image-resources-BpIydXtU.cjs';
+import '../ooxml-tree-BU0e3DVi.cjs';
+import '../semantic-records-CJR3BvHs.cjs';
+import '../revision-projection-72ZApe-g.cjs';
+import '../ooxml-package-CR5us6ad.cjs';

package/dist/contracts/editor.d.ts

@@ -0,0 +1,11 @@
+export { ContentControlSummary, DocEdits, DocQueries, DocQueryResults, ParagraphSummary } from './document.js';
+export { C as CommentRecord, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind } from '../review-support-Fy3vdIea.js';
+export { A as AuthoredNoteNumbering, C as CanResult, p as DocumentChange, q as DocumentEditingMode, r as DocumentHandle, D as DocumentSource, l as Editor, a as EditorCommand, t as EditorCommandShape, u as EditorCommands, w as EditorError, x as EditorEvents, E as EditorFontError, y as EditorFontErrorCode, z as EditorHeaderFooterCommands, B as EditorNoteCommands, G as EditorPosition, H as EditorQueries, J as EditorQuery, K as EditorQueryResults, L as EditorScope, M as EditorSelection, N as EditorSnapshot, F as FontConfiguration, k as FontFaceRequest, i as FontSource, j as FontSourceSubstitution, O as FurnitureVariant, P as HeaderFooterSlotArgs, Q as HeaderFooterState, R as HyperlinkInfo, I as ImageContext, b as ImageCropPercent, U as InteractionAffinity, W as InteractionOutcome, X as InteractionOutcomeCode, Y as NoteKind, Z as NotePropertiesSide, _ as NotePropertiesState, $ as PageSetup, a0 as ResolvedNoteNumbering, a1 as ReviewCommentPlacement, a2 as ReviewCustomPlacement, a3 as ReviewItemPlacement, a4 as ReviewItemPlacementBase, a5 as ReviewItemQuery, a6 as ReviewRevisionPlacement, S as SelectedImageState, a7 as SemanticIdentity, a8 as SemanticTarget, T as TableBorderEdgeTarget, m as TableBorderSpec, n as TableBorderStyle, a9 as TableBorderTarget, aa as TableCellVerticalAlignment, ab as TableColumnDividerResizeTarget, ac as TableColumnOccurrenceTarget, o as TableContext, ad as TableRightEdgeResizeTarget, ae as TableRowOccurrenceTarget, af as TextMatch, V as ViewScope } from '../editor-C1QRi1v4.js';
+export { S as SemanticPosition, a as SemanticSelection } from '../semantic-interaction-Dy-dCUFF.js';
+export { Block, ColorValue, ContainerRef, ContentControl, ContentControlFilter, ContentControlType, DocAnchor, DocAnchorRange, DocComment, DocLocation, DocRange, DocTarget, DocumentBody, DocxDocument, DocxDocumentJSON, ExecErrorCode, ExecResult, Extent, FontDefinition, HeaderFooterSet, IndentFormatting, NumberingRef, PageMargins, Paragraph, Point, Rect, Revision, RevisionType, Run, RunFormatting, Section, SectionProperties, StyleDefinition, StyleDefinitions, Table, TableCell, TableRow, Theme, ThemeColorScheme, Unsubscribe, Watermark } from './types.js';
+export { f as DrawingHorizontalReferenceFrame, c as DrawingKind, e as DrawingLocks, d as DrawingPositionInput, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, R as RevisionAddress } from '../tree-op-types-CwOeiaQ8.js';
+export { I as ImageResourceState, P as PreservedImageMime, R as RenderableImageMime, S as SupportedImageMime, V as ValidatedImageBytesHandle, a as VectorImageMime } from '../image-resources-BJnTpG66.js';
+import '../ooxml-tree-BU0e3DVi.js';
+import '../semantic-records-CWodBJsz.js';
+import '../revision-projection-DHAkcD_L.js';
+import '../ooxml-package-D_CtywTW.js';

package/dist/contracts/editor.js

@@ -0,0 +1 @@
+export{a as EditorFontError}from'../chunk-REZUWYB7.js';

package/dist/contracts/interaction.cjs

@@ -0,0 +1 @@
+'use strict';