@a3s-lab/office 0.45.0 → 0.47.0

package/dist/internal/features/work/editors/document-command-catalog.d.ts

@@ -23,6 +23,11 @@ export declare const documentPictureRibbonTab: {
     readonly label: "图片";
     readonly contextual: true;
 };
+export declare const documentTextBoxRibbonTab: {
+    readonly id: "textBox";
+    readonly label: "文本框";
+    readonly contextual: true;
+};
 export declare const documentTableRibbonTabs: readonly [{
     readonly id: "tableDesign";
     readonly label: "表格设计";
@@ -41,7 +46,7 @@ export declare const documentPageChromeRibbonTab: {
     readonly contextual: true;
 };
 export type DocumentStandardRibbonTabId = (typeof documentRibbonTabs)[number]['id'];
-export type DocumentRibbonTabId = DocumentStandardRibbonTabId | typeof documentPictureRibbonTab.id | (typeof documentTableRibbonTabs)[number]['id'] | typeof documentPageChromeRibbonTab.id;
+export type DocumentRibbonTabId = DocumentStandardRibbonTabId | typeof documentPictureRibbonTab.id | typeof documentTextBoxRibbonTab.id | (typeof documentTableRibbonTabs)[number]['id'] | typeof documentPageChromeRibbonTab.id;
 export interface DocumentCommandShortcut {
     label: string;
     aria: string;
@@ -533,6 +538,15 @@ export declare const documentCommandCatalog: {
             readonly editor: readonly ["Mod-Enter"];
         };
     };
+    readonly insertTextBox: {
+        readonly id: "insert.textBox";
+        readonly label: "插入文本框";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "insert";
+            readonly group: "text";
+        };
+    };
     readonly hyperlink: {
         readonly id: "insert.hyperlink";
         readonly label: "添加链接";

package/dist/internal/features/work/editors/document-text-box-ribbon.d.ts

@@ -0,0 +1,4 @@
+import type { Editor } from '@tiptap/core';
+export declare function DocumentTextBoxRibbon({ editor }: {
+    editor: Editor;
+}): import("react").JSX.Element;

package/dist/internal/features/work/editors/document-toolbar.d.ts

@@ -39,6 +39,7 @@ interface DocumentToolbarProps {
     pageChromeEditingPart: DocumentPageChromeEditingPart | null;
     pageChromeShowPageNumber: boolean;
     onRequestImage: () => void;
+    onInsertTextBox?: () => void;
     onPageChromeEditingPartChange: (part: DocumentPageChromeEditingPart) => void;
     onClosePageChrome: () => void;
     onTogglePageChromePageNumber: () => void;
@@ -86,5 +87,5 @@ interface DocumentToolbarProps {
     onOpenWordCount: () => void;
     onOpenFindReplace: (mode: DocumentFindReplaceMode) => void;
 }
-export declare function DocumentToolbar({ editor, defaultRibbonCollapsed, reviewOnly, suggestionOnly, history, layoutOpen, layout, layoutFonts, navigationOpen, pageColor, showPageNumbers, showHiddenText, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onPageChromeEditingPartChange, onClosePageChrome, onTogglePageChromePageNumber, onToggleLayout, onLayoutChange, onOpenLayout, onToggleNavigation, onTogglePageNumbers, onToggleHiddenText, onToggleRulers, onPageColorChange, onToggleSpellcheck, onViewModeChange, onZoomChange, onZoomFit, onInsertSection, onInsertNote, onInsertCaption, onInsertCrossReference, onOpenTableOfContents, onOpenIndexEntry, onOpenIndex, citationsOpen, citationSourceCount, onToggleCitations, onInsertField, onRefreshFields, onRefreshIndex, onRefreshTableOfContents, canInsertComment, onInsertComment, commentsOpen, commentCount, onToggleComments, trackChanges, changesOpen, changeCount, findReplaceMode, fileActions, onRibbonTabChange, onToggleTrackChanges, onToggleChanges, onOpenComparison, onDecideChange, onOpenWordCount, onOpenFindReplace, }: DocumentToolbarProps): import("react").JSX.Element;
+export declare function DocumentToolbar({ editor, defaultRibbonCollapsed, reviewOnly, suggestionOnly, history, layoutOpen, layout, layoutFonts, navigationOpen, pageColor, showPageNumbers, showHiddenText, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onInsertTextBox, onPageChromeEditingPartChange, onClosePageChrome, onTogglePageChromePageNumber, onToggleLayout, onLayoutChange, onOpenLayout, onToggleNavigation, onTogglePageNumbers, onToggleHiddenText, onToggleRulers, onPageColorChange, onToggleSpellcheck, onViewModeChange, onZoomChange, onZoomFit, onInsertSection, onInsertNote, onInsertCaption, onInsertCrossReference, onOpenTableOfContents, onOpenIndexEntry, onOpenIndex, citationsOpen, citationSourceCount, onToggleCitations, onInsertField, onRefreshFields, onRefreshIndex, onRefreshTableOfContents, canInsertComment, onInsertComment, commentsOpen, commentCount, onToggleComments, trackChanges, changesOpen, changeCount, findReplaceMode, fileActions, onRibbonTabChange, onToggleTrackChanges, onToggleChanges, onOpenComparison, onDecideChange, onOpenWordCount, onOpenFindReplace, }: DocumentToolbarProps): import("react").JSX.Element;
 export {};

package/dist/internal/features/work/editors/use-document-insert-commands.d.ts

@@ -11,6 +11,7 @@ export interface DocumentInsertCommands {
     insertField: (kind: WorkDocumentFieldKind) => void;
     insertImage: (file: File) => Promise<void>;
     insertNote: (kind: WorkDocumentNoteKind) => boolean;
+    insertTextBox: () => boolean;
     openIndexEntry: () => void;
     openIndex: () => void;
     openTableOfContents: () => void;

package/dist/internal/features/work/work-document-field-node.d.ts

@@ -1,10 +1,10 @@
 import { Node } from '@tiptap/core';
-import { type WorkDocumentFieldKind, type WorkDocumentFieldRefreshOptions } from './work-document-fields';
+import { type WorkDocumentFieldInsertOptions, type WorkDocumentFieldKind, type WorkDocumentFieldRefreshOptions } from './work-document-fields';
 import type { WorkDocumentContent } from './work-types';
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         documentField: {
-            insertDocumentField: (kind: WorkDocumentFieldKind) => ReturnType;
+            insertDocumentField: (kind: WorkDocumentFieldKind, options?: WorkDocumentFieldInsertOptions) => ReturnType;
             refreshDocumentFields: (content: WorkDocumentContent, options?: WorkDocumentFieldRefreshOptions) => ReturnType;
         };
     }

package/dist/internal/features/work/work-document-fields.d.ts

@@ -1,9 +1,17 @@
-export type WorkDocumentFieldKind = 'page' | 'numPages' | 'section' | 'sectionPages' | 'date' | 'time';
+export type WorkDocumentFieldKind = 'page' | 'numPages' | 'section' | 'sectionPages' | 'date' | 'time' | 'wordCount' | 'characterCount' | 'pageReference';
 export interface WorkDocumentFieldContext {
     pageNumber: number;
     totalPages: number;
     sectionNumber: number;
     sectionPages: number;
+    /** Number of visible body words, excluding generated field results. */
+    wordCount?: number;
+    /** Number of visible body characters, including spaces. */
+    characterCount?: number;
+    /** Page number resolved for a PAGEREF target, when the target is present. */
+    referencePageNumber?: number | null;
+    /** Page numbers keyed by `id:<bookmark-id>` or `name:<bookmark-name>`. */
+    bookmarkPageNumbers?: ReadonlyMap<string, number>;
     now?: Date;
 }
 export type WorkDocumentFieldContextResolver = (position: number) => WorkDocumentFieldContext | null;
@@ -13,10 +21,36 @@ export interface WorkDocumentFieldRefreshOptions {
     addToHistory?: boolean;
     updateClock?: boolean;
 }
+export interface WorkDocumentFieldInsertOptions {
+    /** Bookmark identity used to keep a page reference stable across renames. */
+    targetId?: string;
+    /** Bookmark name emitted in the native PAGEREF instruction. */
+    targetName?: string;
+}
 export declare function documentFieldKind(value: string | undefined): WorkDocumentFieldKind | null;
 export declare function docxDocumentFieldKind(instruction: string): WorkDocumentFieldKind | null;
-export declare function documentFieldInstruction(kind: WorkDocumentFieldKind): string;
+export declare function documentFieldInstruction(kind: WorkDocumentFieldKind, options?: WorkDocumentFieldInsertOptions): string;
+/** Builds a stable PAGEREF instruction while retaining the supported switches. */
+export declare function documentPageReferenceInstruction(targetName: unknown, source?: string, defaultHyperlink?: boolean): string;
 export declare function documentFieldLabel(kind: WorkDocumentFieldKind): string;
 export declare function documentFieldDisplay(kind: WorkDocumentFieldKind, context: WorkDocumentFieldContext, instruction?: string, cachedValue?: string): string;
 export declare function normalizeDocumentFieldsHtml(source: string): string;
 export declare function resolveDocumentFieldsHtml(source: string, context: WorkDocumentFieldContext): string;
+/** Returns the bookmark name used by a bounded PAGEREF instruction. */
+export declare function docxDocumentFieldTarget(instruction: string): string | null;
+/**
+ * The editor intentionally accepts only switches whose result can be
+ * represented by one deterministic inline atom.  Unknown switches remain
+ * cached text instead of being presented as an editable field with altered
+ * semantics.
+ */
+export declare function supportedDocxDocumentFieldInstruction(instruction: string): boolean;
+export declare function documentFieldStatisticsFromText(source: string): {
+    wordCount: number;
+    characterCount: number;
+};
+/** Computes bounded body statistics while excluding generated field results. */
+export declare function documentFieldStatisticsFromHtml(source: string): {
+    wordCount: number;
+    characterCount: number;
+};

package/dist/internal/features/work/work-document-text-box.d.ts

@@ -0,0 +1,64 @@
+import { type Editor, Node } from '@tiptap/core';
+/** The intentionally small text-box surface supported by Writer. */
+export type WorkDocumentTextBoxLayout = 'inline' | 'floating';
+export type WorkDocumentTextBoxHorizontalReference = 'column' | 'margin' | 'page';
+export type WorkDocumentTextBoxVerticalReference = 'paragraph' | 'margin' | 'page';
+export type WorkDocumentTextBoxVerticalAlign = 'top' | 'center' | 'bottom';
+export interface WorkDocumentTextBoxProperties {
+    id: string;
+    width: number;
+    height: number;
+    layout: WorkDocumentTextBoxLayout;
+    horizontalOffset: number | null;
+    verticalOffset: number | null;
+    horizontalReference: WorkDocumentTextBoxHorizontalReference;
+    verticalReference: WorkDocumentTextBoxVerticalReference;
+    fill: string;
+    borderColor: string;
+    borderWidth: number;
+    padding: number;
+    verticalAlign: WorkDocumentTextBoxVerticalAlign;
+    docPropertiesId: number | null;
+}
+export interface DocumentTextBoxCommandOptions {
+    restoreFocus?: boolean;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        documentTextBox: {
+            insertDocumentTextBox: (text?: string, options?: Partial<WorkDocumentTextBoxProperties>) => ReturnType;
+            setDocumentTextBoxProperties: (value: Partial<WorkDocumentTextBoxProperties>, options?: DocumentTextBoxCommandOptions) => ReturnType;
+            deleteDocumentTextBox: (options?: DocumentTextBoxCommandOptions) => ReturnType;
+        };
+    }
+}
+export declare const DOCUMENT_TEXT_BOX_DEFAULTS: WorkDocumentTextBoxProperties;
+export declare const DOCUMENT_TEXT_BOX_LIMITS: {
+    readonly width: {
+        readonly min: 20;
+        readonly max: 558.7;
+    };
+    readonly height: {
+        readonly min: 10;
+        readonly max: 558.7;
+    };
+    readonly offset: {
+        readonly min: -558.7;
+        readonly max: 558.7;
+    };
+    readonly borderWidth: {
+        readonly min: 0;
+        readonly max: 10;
+    };
+    readonly padding: {
+        readonly min: 0;
+        readonly max: 25;
+    };
+};
+export declare const DocumentTextBox: Node<any, any>;
+export declare function documentTextBoxProperties(editor: Editor): WorkDocumentTextBoxProperties;
+export declare function setDocumentTextBoxProperties(editor: Editor, value: Partial<WorkDocumentTextBoxProperties>, options?: DocumentTextBoxCommandOptions): boolean;
+export declare function normalizeDocumentTextBoxProperties(value: Partial<Record<keyof WorkDocumentTextBoxProperties, unknown>>): WorkDocumentTextBoxProperties;
+export declare function textBoxCss(value: Partial<Record<keyof WorkDocumentTextBoxProperties, unknown>>): string;
+export declare function textBoxDomAttributes(value: Partial<Record<keyof WorkDocumentTextBoxProperties, unknown>>): Record<string, string | undefined>;
+export declare function documentTextBoxPropertiesFromElement(element: Element): WorkDocumentTextBoxProperties;

package/dist/internal/features/work/work-docx-bookmark-import.d.ts

@@ -2,7 +2,7 @@ export interface ImportedDocxBookmarkMarkers {
     bookmarks: ImportedDocxBookmarkMarker[];
     references: ImportedDocxBookmarkReferenceMarker[];
 }
-interface ImportedDocxBookmarkMarker {
+export interface ImportedDocxBookmarkMarker {
     start: string;
     end: string;
     id: string;

package/dist/internal/features/work/work-docx-field-import.d.ts

@@ -1,4 +1,5 @@
 import { type WorkDocumentFieldKind } from './work-document-fields';
+import type { ImportedDocxBookmarkMarker } from './work-docx-bookmark-import';
 export interface ImportedDocxFieldMarkers {
     fields: ImportedDocxFieldMarker[];
 }
@@ -9,8 +10,11 @@ interface ImportedDocxFieldMarker {
     kind: WorkDocumentFieldKind;
     instruction: string;
     display: string;
+    targetId?: string;
+    targetName?: string;
+    orphaned?: boolean;
 }
-export declare function markDocxBodyFields(document: Document): ImportedDocxFieldMarkers;
+export declare function markDocxBodyFields(document: Document, bookmarks?: readonly ImportedDocxBookmarkMarker[]): ImportedDocxFieldMarkers;
 export declare function applyImportedDocxFieldMarkers(document: Document, markers: ImportedDocxFieldMarkers): void;
 export declare function hasImportedDocxFieldMarkers(markers: ImportedDocxFieldMarkers): boolean;
 export {};

package/dist/internal/features/work/work-docx-import.d.ts

@@ -24,6 +24,7 @@ import { type ImportedDocxTableCellMarkers } from './work-docx-table-cell-import
 import { type ImportedDocxTableOfContentsMarkers } from './work-docx-table-of-contents-import';
 import { type ImportedDocxTableRowMarkers } from './work-docx-table-row-import';
 import { type ImportedDocxTableSizingMarkers } from './work-docx-table-sizing-import';
+import { type ImportedDocxTextBoxMarkers } from './work-docx-text-box-import';
 import { OoxmlPackage } from './work-ooxml-package';
 import type { WorkDocumentContent, WorkDocumentSectionLayout } from './work-types';
 type ImportedDocumentLayout = Omit<WorkDocumentContent, 'type' | 'html'>;
@@ -46,6 +47,7 @@ export interface PreparedDocxImport {
     listMarkers: ImportedDocxListMarkers;
     numberingChangeMarkers: ImportedDocxNumberingChangeMarkers;
     imageLayoutMarkers: ImportedDocxImageLayoutMarkers;
+    textBoxMarkers: ImportedDocxTextBoxMarkers;
     paragraphIdentityMarkers: ImportedDocxParagraphIdentityMarkers;
     paragraphFormattingChangeMarkers: ImportedDocxParagraphFormattingChangeMarkers;
     paragraphAlignmentMarkers: ImportedDocxParagraphAlignmentMarkers;
@@ -64,6 +66,6 @@ export interface PreparedDocxImport {
     trackChanges: boolean;
 }
 export declare function prepareDocxImport(buffer: ArrayBuffer, sourcePackage?: OoxmlPackage): Promise<PreparedDocxImport>;
-export declare function applyDocxSectionsToHtml(html: string, sections: PreparedDocxImport['sections'], captionMarkers?: ImportedDocxCaptionMarkers, bookmarkMarkers?: ImportedDocxBookmarkMarkers, changeMarkers?: ImportedDocxChangeMarkers, commentMarkers?: ImportedDocxCommentMarkers, fieldMarkers?: ImportedDocxFieldMarkers, tableOfContentsMarkers?: ImportedDocxTableOfContentsMarkers, indexMarkers?: ImportedDocxIndexMarkers, equationMarkers?: ImportedDocxEquationMarkers, citationMarkers?: ImportedDocxCitationMarkers, listMarkers?: ImportedDocxListMarkers, numberingChangeMarkers?: ImportedDocxNumberingChangeMarkers, imageLayoutMarkers?: ImportedDocxImageLayoutMarkers, paragraphIdentityMarkers?: ImportedDocxParagraphIdentityMarkers, paragraphFormattingChangeMarkers?: ImportedDocxParagraphFormattingChangeMarkers, paragraphAlignmentMarkers?: ImportedDocxParagraphAlignmentMarkers, runFormattingMarkers?: ImportedDocxRunFormattingMarkers, paragraphDirectionMarkers?: ImportedDocxParagraphDirectionMarkers, paragraphIndentMarkers?: ImportedDocxParagraphIndentMarkers, paragraphSpacingMarkers?: ImportedDocxParagraphSpacingMarkers, paragraphBorderMarkers?: ImportedDocxParagraphBorderMarkers, paragraphShadingMarkers?: ImportedDocxParagraphShadingMarkers, paragraphPaginationMarkers?: ImportedDocxParagraphPaginationMarkers, bibliography?: WorkDocumentContent['bibliography'], tabStopMarkers?: ImportedDocxParagraphTabStopMarkers, tableCellMarkers?: ImportedDocxTableCellMarkers, tableRowMarkers?: ImportedDocxTableRowMarkers, tableSizingMarkers?: ImportedDocxTableSizingMarkers): string;
+export declare function applyDocxSectionsToHtml(html: string, sections: PreparedDocxImport['sections'], captionMarkers?: ImportedDocxCaptionMarkers, bookmarkMarkers?: ImportedDocxBookmarkMarkers, changeMarkers?: ImportedDocxChangeMarkers, commentMarkers?: ImportedDocxCommentMarkers, fieldMarkers?: ImportedDocxFieldMarkers, tableOfContentsMarkers?: ImportedDocxTableOfContentsMarkers, indexMarkers?: ImportedDocxIndexMarkers, equationMarkers?: ImportedDocxEquationMarkers, citationMarkers?: ImportedDocxCitationMarkers, listMarkers?: ImportedDocxListMarkers, numberingChangeMarkers?: ImportedDocxNumberingChangeMarkers, imageLayoutMarkers?: ImportedDocxImageLayoutMarkers, paragraphIdentityMarkers?: ImportedDocxParagraphIdentityMarkers, paragraphFormattingChangeMarkers?: ImportedDocxParagraphFormattingChangeMarkers, paragraphAlignmentMarkers?: ImportedDocxParagraphAlignmentMarkers, runFormattingMarkers?: ImportedDocxRunFormattingMarkers, paragraphDirectionMarkers?: ImportedDocxParagraphDirectionMarkers, paragraphIndentMarkers?: ImportedDocxParagraphIndentMarkers, paragraphSpacingMarkers?: ImportedDocxParagraphSpacingMarkers, paragraphBorderMarkers?: ImportedDocxParagraphBorderMarkers, paragraphShadingMarkers?: ImportedDocxParagraphShadingMarkers, paragraphPaginationMarkers?: ImportedDocxParagraphPaginationMarkers, bibliography?: WorkDocumentContent['bibliography'], tabStopMarkers?: ImportedDocxParagraphTabStopMarkers, tableCellMarkers?: ImportedDocxTableCellMarkers, tableRowMarkers?: ImportedDocxTableRowMarkers, tableSizingMarkers?: ImportedDocxTableSizingMarkers, textBoxMarkers?: ImportedDocxTextBoxMarkers): string;
 export declare function readDocxLayout(buffer: ArrayBuffer): Promise<ImportedDocumentLayout>;
 export {};

package/dist/internal/features/work/work-docx-text-box-export.d.ts

@@ -0,0 +1,25 @@
+import type { WorkDocumentTextBoxProperties } from './work-document-text-box';
+interface DocxTextBoxIdentityPatch {
+    marker: string;
+    preferredId: number | null;
+}
+export interface DocxTextBoxIdentityRegistration {
+    marker: string;
+    docPropertiesId: number | null;
+}
+/**
+ * Allocates a marker for each text box and lets the package patcher assign a
+ * document-wide `wp:docPr/@id` after all image and shape IDs are known.
+ *
+ * The `docx` package creates a fresh ID generator per drawing instance, so
+ * relying on its default would give every WPS shape the same ID. Delaying the
+ * assignment also lets us preserve an imported ID when it is still available,
+ * while deterministically repairing collisions with images or other shapes.
+ */
+export declare class DocxTextBoxIdentityPatchCollector {
+    readonly patches: DocxTextBoxIdentityPatch[];
+    private nextMarker;
+    register(properties: WorkDocumentTextBoxProperties): DocxTextBoxIdentityRegistration;
+}
+export declare function patchDocxTextBoxIdentities(buffer: ArrayBuffer, patches: readonly DocxTextBoxIdentityPatch[]): Promise<ArrayBuffer>;
+export {};

package/dist/internal/features/work/work-docx-text-box-import.d.ts

@@ -0,0 +1,26 @@
+import { type WorkDocumentTextBoxProperties } from './work-document-text-box';
+export interface ImportedDocxTextBoxMarker {
+    marker: string;
+    properties: WorkDocumentTextBoxProperties;
+}
+export interface ImportedDocxTextBoxMarkers {
+    textBoxes: ImportedDocxTextBoxMarker[];
+}
+export interface DocxTextBoxInspection {
+    supported: number;
+    unsupported: number;
+}
+/**
+ * Rewrites supported WPS text boxes into ordinary Word runs for Mammoth.
+ * Mammoth intentionally ignores `wps:txbxContent`; the marker is consumed
+ * after conversion and replaced with an editable HTML block.
+ */
+export declare function markDocxTextBoxes(document: Document): ImportedDocxTextBoxMarkers;
+/**
+ * Inspects WPS text-box shapes without mutating the source package. The
+ * importer deliberately supports only a shape that is the sole drawing in a
+ * paragraph; mixed paragraphs remain on Mammoth's normal compatibility path.
+ */
+export declare function inspectDocxTextBoxes(document: Document): DocxTextBoxInspection;
+export declare function applyImportedDocxTextBoxMarkers(document: Document, markers: ImportedDocxTextBoxMarkers): void;
+export declare function hasImportedDocxTextBoxMarkers(markers: ImportedDocxTextBoxMarkers): boolean;

package/dist/styles.css

@@ -12807,6 +12807,69 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   border-bottom-color: #d69b9b;
 }
 
+:where(.work-document-page .tiptap, .work-document-preview-page, .work-pdf-export-page.document) [data-document-text-box] {
+  box-sizing: border-box;
+  width: var(--work-document-text-box-width, 120mm);
+  min-width: 20mm;
+  max-width: 100%;
+  height: var(--work-document-text-box-height, 45mm);
+  min-height: 10mm;
+  max-height: 558.7mm;
+  padding: var(--work-document-text-box-padding, 3mm);
+  border: var(--work-document-text-box-border-width, .35mm) solid
+    var(--work-document-text-box-border-color, #4472c4);
+  background: var(--work-document-text-box-fill, #fff2cc);
+  color: inherit;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  border-radius: 3px;
+  flex-direction: column;
+  justify-content: flex-start;
+  margin: 12px 0;
+  display: flex;
+  overflow: hidden;
+}
+
+:where(.work-document-page .tiptap, .work-document-preview-page, .work-pdf-export-page.document) [data-document-text-box][data-text-box-vertical-align="center"] {
+  justify-content: center;
+}
+
+:where(.work-document-page .tiptap, .work-document-preview-page, .work-pdf-export-page.document) [data-document-text-box][data-text-box-vertical-align="bottom"] {
+  justify-content: flex-end;
+}
+
+:where(.work-document-page .tiptap, .work-document-preview-page, .work-pdf-export-page.document) [data-document-text-box][data-text-box-layout="floating"] {
+  translate: var(--work-document-text-box-horizontal-offset, 0)
+    var(--work-document-text-box-vertical-offset, 0);
+  z-index: 1;
+  position: relative;
+}
+
+:where(.work-document-page .tiptap, .work-document-preview-page, .work-pdf-export-page.document) [data-document-text-box] > p {
+  width: 100%;
+  margin: 0;
+}
+
+.work-document-page .tiptap [data-document-text-box].ProseMirror-selectednode {
+  outline: 2px solid color-mix(in srgb, var(--a3s-blue) 75%, transparent);
+  outline-offset: 3px;
+}
+
+.work-document-text-box-size-field, .work-document-text-box-offset-field {
+  width: 84px;
+}
+
+.work-document-text-box-position-field {
+  width: 96px;
+}
+
+.work-document-text-box-size-field > span, .work-document-text-box-offset-field > span, .work-document-text-box-position-field > span {
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  max-width: 96px;
+  overflow: hidden;
+}
+
 .work-document-citation {
   color: #245fc4;
   cursor: default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -105,6 +105,7 @@
     "playground:visual:document-script-fonts": "playwright test visual-tests/document-script-fonts.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-opentype": "playwright test visual-tests/document-opentype.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-strike": "playwright test visual-tests/document-strike.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:document-text-box": "playwright test visual-tests/document-text-box.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-data-validation": "playwright test visual-tests/spreadsheet-data-validation.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-conditional-format": "playwright test visual-tests/spreadsheet-conditional-format.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-date-time": "playwright test visual-tests/spreadsheet-date-time.functional.spec.ts --config playwright.config.ts",
@@ -138,8 +139,10 @@
     "performance:pdf": "bun .a3s-test/performance/generate-fixtures.ts --pdf-only && bun .a3s-test/performance/benchmark-pdf.ts --url http://127.0.0.1:4175/playground/ --runs 3 --timeout-ms 120000",
     "performance:presentation": "bun .a3s-test/performance/generate-fixtures.ts --presentations-only && bun .a3s-test/performance/benchmark-presentation.ts --url http://127.0.0.1:4175/playground/ --runs 3 --timeout-ms 120000 --modes default,content-visibility",
     "test": "rstest",
-    "test:e2e": "bun run test:e2e:fixtures && a3s-test run tests/e2e/word-page-color.acl --json && a3s-test run tests/e2e/word-page-setup-phone.acl --json && a3s-test run tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test run tests/e2e/word-list-formatting-phone.acl --json && a3s-test run tests/e2e/word-font-picker-phone.acl --json && a3s-test run tests/e2e/word-comments-drawer.acl --json && a3s-test run tests/e2e/word-comment-windowing.acl --json && a3s-test run tests/e2e/word-citations-phone.acl --json && a3s-test run tests/e2e/word-navigation-search.acl --json && a3s-test run tests/e2e/word-navigation-windowing.acl --json && a3s-test run tests/e2e/word-find-replace-phone.acl --json && a3s-test run tests/e2e/word-page-navigation.acl --json && a3s-test run tests/e2e/word-page-windowing.acl --json && a3s-test run tests/e2e/word-ai-question.acl --json && a3s-test run tests/e2e/word-picture-insert.acl --json && a3s-test run tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test run tests/e2e/word-track-changes-phone.acl --json && a3s-test run tests/e2e/word-formatting-revision.acl --json && a3s-test run tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test run tests/e2e/word-numbering-revision.acl --json && a3s-test run tests/e2e/word-document-comparison.acl --json && a3s-test run tests/e2e/word-review-conflict-phone.acl --json && a3s-test run tests/e2e/word-revision-windowing.acl --json && a3s-test run tests/e2e/word-table-phone.acl --json && a3s-test run tests/e2e/word-table-borders.acl --json && a3s-test run tests/e2e/word-theme-table.acl --json && a3s-test run tests/e2e/word-styled-table.acl --json && a3s-test run tests/e2e/word-multi-page-table.acl --json && a3s-test run tests/e2e/word-cross-reference-phone.acl --json && a3s-test run tests/e2e/word-bookmark-links-phone.acl --json && a3s-test run tests/e2e/word-notes-phone.acl --json && a3s-test run tests/e2e/word-fields-phone.acl --json && a3s-test run tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test run tests/e2e/spreadsheet-phone-find.acl --json && a3s-test run tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test run tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test run tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test run tests/e2e/spreadsheet-cell-style.acl --json && a3s-test run tests/e2e/spreadsheet-paste-special.acl --json && a3s-test run tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test run tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test run tests/e2e/presentation-presenter-view.acl --json && a3s-test run tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test run tests/e2e/presentation-phone-comments.acl --json && a3s-test run tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test run tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test run tests/e2e/markdown-phone-modes.acl --json && a3s-test run tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test run tests/e2e/office-docs-navigation.acl --json && a3s-test run tests/e2e/collaboration-playground-entry.acl --json && a3s-test run tests/e2e/collaboration-document-comments.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-document-suggestions.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-participants.acl --json && a3s-test run tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test run tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test run tests/e2e/collaboration-presentation-elements.acl --json",
-    "test:e2e:check": "bun run test:e2e:fixtures && a3s-test check tests/e2e/word-page-color.acl --json && a3s-test check tests/e2e/word-page-setup-phone.acl --json && a3s-test check tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test check tests/e2e/word-list-formatting-phone.acl --json && a3s-test check tests/e2e/word-font-picker-phone.acl --json && a3s-test check tests/e2e/word-comments-drawer.acl --json && a3s-test check tests/e2e/word-comment-windowing.acl --json && a3s-test check tests/e2e/word-citations-phone.acl --json && a3s-test check tests/e2e/word-navigation-search.acl --json && a3s-test check tests/e2e/word-navigation-windowing.acl --json && a3s-test check tests/e2e/word-find-replace-phone.acl --json && a3s-test check tests/e2e/word-page-navigation.acl --json && a3s-test check tests/e2e/word-page-windowing.acl --json && a3s-test check tests/e2e/word-ai-question.acl --json && a3s-test check tests/e2e/word-picture-insert.acl --json && a3s-test check tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test check tests/e2e/word-track-changes-phone.acl --json && a3s-test check tests/e2e/word-formatting-revision.acl --json && a3s-test check tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test check tests/e2e/word-numbering-revision.acl --json && a3s-test check tests/e2e/word-document-comparison.acl --json && a3s-test check tests/e2e/word-review-conflict-phone.acl --json && a3s-test check tests/e2e/word-revision-windowing.acl --json && a3s-test check tests/e2e/word-table-phone.acl --json && a3s-test check tests/e2e/word-table-borders.acl --json && a3s-test check tests/e2e/word-theme-table.acl --json && a3s-test check tests/e2e/word-styled-table.acl --json && a3s-test check tests/e2e/word-multi-page-table.acl --json && a3s-test check tests/e2e/word-cross-reference-phone.acl --json && a3s-test check tests/e2e/word-bookmark-links-phone.acl --json && a3s-test check tests/e2e/word-notes-phone.acl --json && a3s-test check tests/e2e/word-fields-phone.acl --json && a3s-test check tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test check tests/e2e/spreadsheet-phone-find.acl --json && a3s-test check tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test check tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test check tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test check tests/e2e/spreadsheet-cell-style.acl --json && a3s-test check tests/e2e/spreadsheet-paste-special.acl --json && a3s-test check tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test check tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test check tests/e2e/presentation-presenter-view.acl --json && a3s-test check tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test check tests/e2e/presentation-phone-comments.acl --json && a3s-test check tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test check tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test check tests/e2e/markdown-phone-modes.acl --json && a3s-test check tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test check tests/e2e/office-docs-navigation.acl --json && a3s-test check tests/e2e/collaboration-playground-entry.acl --json && a3s-test check tests/e2e/collaboration-document-comments.acl --json && a3s-test check tests/e2e/collaboration-document-suggestions.acl --json && a3s-test check tests/e2e/collaboration-participants.acl --json && a3s-test check tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test check tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test check tests/e2e/collaboration-presentation-elements.acl --json",
+    "test:e2e": "bun run test:e2e:fixtures && a3s-test run tests/e2e/word-page-color.acl --json && a3s-test run tests/e2e/word-page-setup-phone.acl --json && a3s-test run tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test run tests/e2e/word-list-formatting-phone.acl --json && a3s-test run tests/e2e/word-font-picker-phone.acl --json && a3s-test run tests/e2e/word-comments-drawer.acl --json && a3s-test run tests/e2e/word-comment-windowing.acl --json && a3s-test run tests/e2e/word-citations-phone.acl --json && a3s-test run tests/e2e/word-navigation-search.acl --json && a3s-test run tests/e2e/word-navigation-windowing.acl --json && a3s-test run tests/e2e/word-find-replace-phone.acl --json && a3s-test run tests/e2e/word-page-navigation.acl --json && a3s-test run tests/e2e/word-page-windowing.acl --json && a3s-test run tests/e2e/word-ai-question.acl --json && a3s-test run tests/e2e/word-picture-insert.acl --json && a3s-test run tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test run tests/e2e/word-text-box-phone.acl --json && a3s-test run tests/e2e/word-track-changes-phone.acl --json && a3s-test run tests/e2e/word-formatting-revision.acl --json && a3s-test run tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test run tests/e2e/word-numbering-revision.acl --json && a3s-test run tests/e2e/word-document-comparison.acl --json && a3s-test run tests/e2e/word-review-conflict-phone.acl --json && a3s-test run tests/e2e/word-revision-windowing.acl --json && a3s-test run tests/e2e/word-table-phone.acl --json && a3s-test run tests/e2e/word-table-borders.acl --json && a3s-test run tests/e2e/word-theme-table.acl --json && a3s-test run tests/e2e/word-styled-table.acl --json && a3s-test run tests/e2e/word-multi-page-table.acl --json && a3s-test run tests/e2e/word-cross-reference-phone.acl --json && a3s-test run tests/e2e/word-bookmark-links-phone.acl --json && a3s-test run tests/e2e/word-notes-phone.acl --json && a3s-test run tests/e2e/word-fields-phone.acl --json && a3s-test run tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test run tests/e2e/spreadsheet-phone-find.acl --json && a3s-test run tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test run tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test run tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test run tests/e2e/spreadsheet-cell-style.acl --json && a3s-test run tests/e2e/spreadsheet-paste-special.acl --json && a3s-test run tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test run tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test run tests/e2e/presentation-presenter-view.acl --json && a3s-test run tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test run tests/e2e/presentation-phone-comments.acl --json && a3s-test run tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test run tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test run tests/e2e/markdown-phone-modes.acl --json && a3s-test run tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test run tests/e2e/office-docs-navigation.acl --json && a3s-test run tests/e2e/collaboration-playground-entry.acl --json && a3s-test run tests/e2e/collaboration-document-comments.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-document-suggestions.acl --command-timeout-ms 120000 --json && a3s-test run tests/e2e/collaboration-participants.acl --json && a3s-test run tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test run tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test run tests/e2e/collaboration-presentation-elements.acl --json",
+    "test:e2e:check": "bun run test:e2e:fixtures && a3s-test check tests/e2e/word-page-color.acl --json && a3s-test check tests/e2e/word-page-setup-phone.acl --json && a3s-test check tests/e2e/word-paragraph-layout-phone.acl --json && a3s-test check tests/e2e/word-list-formatting-phone.acl --json && a3s-test check tests/e2e/word-font-picker-phone.acl --json && a3s-test check tests/e2e/word-comments-drawer.acl --json && a3s-test check tests/e2e/word-comment-windowing.acl --json && a3s-test check tests/e2e/word-citations-phone.acl --json && a3s-test check tests/e2e/word-navigation-search.acl --json && a3s-test check tests/e2e/word-navigation-windowing.acl --json && a3s-test check tests/e2e/word-find-replace-phone.acl --json && a3s-test check tests/e2e/word-page-navigation.acl --json && a3s-test check tests/e2e/word-page-windowing.acl --json && a3s-test check tests/e2e/word-ai-question.acl --json && a3s-test check tests/e2e/word-picture-insert.acl --json && a3s-test check tests/e2e/word-picture-alt-text-phone.acl --json && a3s-test check tests/e2e/word-text-box-phone.acl --json && a3s-test check tests/e2e/word-track-changes-phone.acl --json && a3s-test check tests/e2e/word-formatting-revision.acl --json && a3s-test check tests/e2e/word-paragraph-formatting-revision.acl --json && a3s-test check tests/e2e/word-numbering-revision.acl --json && a3s-test check tests/e2e/word-document-comparison.acl --json && a3s-test check tests/e2e/word-review-conflict-phone.acl --json && a3s-test check tests/e2e/word-revision-windowing.acl --json && a3s-test check tests/e2e/word-table-phone.acl --json && a3s-test check tests/e2e/word-table-borders.acl --json && a3s-test check tests/e2e/word-theme-table.acl --json && a3s-test check tests/e2e/word-styled-table.acl --json && a3s-test check tests/e2e/word-multi-page-table.acl --json && a3s-test check tests/e2e/word-cross-reference-phone.acl --json && a3s-test check tests/e2e/word-bookmark-links-phone.acl --json && a3s-test check tests/e2e/word-notes-phone.acl --json && a3s-test check tests/e2e/word-fields-phone.acl --json && a3s-test check tests/e2e/spreadsheet-phone-rename.acl --json && a3s-test check tests/e2e/spreadsheet-phone-find.acl --json && a3s-test check tests/e2e/spreadsheet-phone-context-menu.acl --json && a3s-test check tests/e2e/spreadsheet-phone-task-pane.acl --json && a3s-test check tests/e2e/spreadsheet-maximum-sparse.acl --json && a3s-test check tests/e2e/spreadsheet-cell-style.acl --json && a3s-test check tests/e2e/spreadsheet-paste-special.acl --json && a3s-test check tests/e2e/spreadsheet-hyperlink.acl --json && a3s-test check tests/e2e/presentation-cut-paste-focus.acl --json && a3s-test check tests/e2e/presentation-presenter-view.acl --json && a3s-test check tests/e2e/presentation-phone-chart-pane.acl --json && a3s-test check tests/e2e/presentation-phone-comments.acl --json && a3s-test check tests/e2e/pdf-thumbnail-keyboard.acl --json && a3s-test check tests/e2e/pdf-page-drawer-phone.acl --json && a3s-test check tests/e2e/markdown-phone-modes.acl --json && a3s-test check tests/e2e/office-sidebar-breakpoint.acl --json && a3s-test check tests/e2e/office-docs-navigation.acl --json && a3s-test check tests/e2e/collaboration-playground-entry.acl --json && a3s-test check tests/e2e/collaboration-document-comments.acl --json && a3s-test check tests/e2e/collaboration-document-suggestions.acl --json && a3s-test check tests/e2e/collaboration-participants.acl --json && a3s-test check tests/e2e/collaboration-pdf-annotations.acl --json && a3s-test check tests/e2e/collaboration-spreadsheet-cells.acl --json && a3s-test check tests/e2e/collaboration-presentation-elements.acl --json",
+    "test:e2e:writer-text-box": "bun run test:e2e:fixtures && A3S_TEST_SUITE=tests/e2e/word-text-box-phone.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:writer-text-box:check": "a3s-test check tests/e2e/word-text-box-phone.acl --json",
     "test:e2e:fixtures": "bun scripts/create-e2e-fixtures.ts",
     "test:e2e:numbering-revision": "A3S_TEST_SUITE=tests/e2e/word-numbering-revision.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:numbering-revision:check": "a3s-test check tests/e2e/word-numbering-revision.acl --json",