@a3s-lab/office 0.46.0 → 0.48.0

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

@@ -547,6 +547,15 @@ export declare const documentCommandCatalog: {
             readonly group: "text";
         };
     };
+    readonly insertContentControl: {
+        readonly id: "insert.contentControl";
+        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-content-control-dialog.d.ts

@@ -0,0 +1,10 @@
+import type { WorkDocumentContentControlProperties } from '../work-document-content-control';
+export interface DocumentContentControlDialogProps {
+    editing: boolean;
+    properties: WorkDocumentContentControlProperties;
+    restoreFocusTarget: () => HTMLElement | null;
+    onCancel: () => void;
+    onChange: (properties: WorkDocumentContentControlProperties) => void;
+    onSubmit: () => void;
+}
+export declare function DocumentContentControlDialog({ editing, properties, restoreFocusTarget, onCancel, onChange, onSubmit, }: DocumentContentControlDialogProps): import("react").JSX.Element;

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

@@ -40,6 +40,7 @@ interface DocumentToolbarProps {
     pageChromeShowPageNumber: boolean;
     onRequestImage: () => void;
     onInsertTextBox?: () => void;
+    onInsertContentControl?: () => void;
     onPageChromeEditingPartChange: (part: DocumentPageChromeEditingPart) => void;
     onClosePageChrome: () => void;
     onTogglePageChromePageNumber: () => void;
@@ -87,5 +88,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, 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 declare function DocumentToolbar({ editor, defaultRibbonCollapsed, reviewOnly, suggestionOnly, history, layoutOpen, layout, layoutFonts, navigationOpen, pageColor, showPageNumbers, showHiddenText, showRulers, spellcheckEnabled, viewMode, zoom, pageChromeEditor, pageChromeEditingPart, pageChromeShowPageNumber, onRequestImage, onInsertTextBox, onInsertContentControl, 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

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

package/dist/internal/features/work/work-document-content-control.d.ts

@@ -0,0 +1,59 @@
+import { type Editor, Node } from '@tiptap/core';
+import { type Node as ProseMirrorNode } from '@tiptap/pm/model';
+/**
+ * The deliberately small content-control surface exposed by Writer.
+ *
+ * Data binding, repeating sections, dates, drop-downs, pictures, and other
+ * active form semantics are intentionally not represented by this model. A
+ * control is an inline, editable container whose metadata can round-trip to a
+ * passive Word `w:sdt`.
+ */
+export type WorkDocumentContentControlType = 'text' | 'richText';
+export type WorkDocumentContentControlLock = 'unlocked' | 'contentLocked' | 'sdtLocked' | 'sdtContentLocked';
+export type WorkDocumentContentControlAppearance = 'boundingBox' | 'hidden' | 'tags';
+export interface WorkDocumentContentControlProperties {
+    id: string;
+    nativeId: number | null;
+    type: WorkDocumentContentControlType;
+    alias: string;
+    tag: string;
+    lock: WorkDocumentContentControlLock;
+    multiLine: boolean;
+    appearance: WorkDocumentContentControlAppearance;
+    color: string | null;
+}
+export interface DocumentContentControlInsertOptions extends Partial<WorkDocumentContentControlProperties> {
+    /** Initial plain text for an empty selection. */
+    text?: string;
+}
+export interface DocumentContentControlCommandOptions {
+    restoreFocus?: boolean;
+    /** Explicitly permits deleting a control whose `w:sdt` is locked. */
+    allowLocked?: boolean;
+}
+export interface SelectedDocumentContentControl {
+    node: ProseMirrorNode;
+    position: number;
+}
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        documentContentControl: {
+            insertDocumentContentControl: (options?: DocumentContentControlInsertOptions) => ReturnType;
+            setDocumentContentControlProperties: (value: Partial<WorkDocumentContentControlProperties>, options?: DocumentContentControlCommandOptions) => ReturnType;
+            deleteDocumentContentControl: (options?: DocumentContentControlCommandOptions) => ReturnType;
+        };
+    }
+}
+export declare const DOCUMENT_CONTENT_CONTROL_DEFAULTS: WorkDocumentContentControlProperties;
+/** Transaction meta used by the typed commands to cross the lock guard. */
+export declare const DOCUMENT_CONTENT_CONTROL_MUTATION_META = "documentContentControlMutation";
+export declare const DocumentContentControl: Node<any, any>;
+export declare function documentContentControlProperties(editor: Editor): WorkDocumentContentControlProperties;
+export declare function setDocumentContentControlProperties(editor: Editor, value: Partial<WorkDocumentContentControlProperties>, options?: DocumentContentControlCommandOptions): boolean;
+export declare function selectedDocumentContentControl(stateOrEditor: Editor | Editor['state']): SelectedDocumentContentControl | null;
+export declare function normalizeDocumentContentControlProperties(value: Partial<Record<keyof WorkDocumentContentControlProperties, unknown>>): WorkDocumentContentControlProperties;
+export declare function contentControlLocksContent(value: WorkDocumentContentControlLock | unknown): boolean;
+export declare function contentControlLocksShell(value: WorkDocumentContentControlLock | unknown): boolean;
+export declare function contentControlCss(value: Partial<Record<keyof WorkDocumentContentControlProperties, unknown>>): string;
+export declare function contentControlDomAttributes(value: Partial<Record<keyof WorkDocumentContentControlProperties, unknown>>): Record<string, string | undefined>;
+export declare function documentContentControlPropertiesFromElement(element: Element): WorkDocumentContentControlProperties;

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-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-content-control-export.d.ts

@@ -0,0 +1,24 @@
+import type { ParagraphChild } from 'docx';
+import { type WorkDocumentContentControlProperties } from './work-document-content-control';
+export interface DocxContentControlPatch {
+    startMarker: string;
+    endMarker: string;
+    properties: WorkDocumentContentControlProperties;
+}
+export interface DocxContentControlMarkerRegistration {
+    startMarker: string;
+    endMarker: string;
+}
+/** Collects native content-control patches while the docx package is built. */
+export declare class DocxContentControlPatchCollector {
+    readonly patches: DocxContentControlPatch[];
+    private nextMarker;
+    register(properties: WorkDocumentContentControlProperties): DocxContentControlMarkerRegistration;
+}
+export declare function docxContentControlRuns(element: HTMLElement, docx: typeof import('docx'), collector: DocxContentControlPatchCollector, children: ParagraphChild[]): ParagraphChild[];
+/**
+ * Replaces generated marker runs with native inline `w:sdt` controls in every
+ * Word story. The patcher is intentionally conservative: a marker pair must
+ * be in one paragraph and may contain only generated runs.
+ */
+export declare function patchDocxContentControls(buffer: ArrayBuffer, patches: readonly DocxContentControlPatch[]): Promise<ArrayBuffer>;

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

@@ -0,0 +1,28 @@
+import { type WorkDocumentContentControlProperties } from './work-document-content-control';
+export interface ImportedDocxContentControlMarker {
+    start: string;
+    end: string;
+    properties: WorkDocumentContentControlProperties;
+}
+export interface ImportedDocxContentControlMarkers {
+    controls: ImportedDocxContentControlMarker[];
+    unsupported: number;
+}
+export interface DocxContentControlInspection {
+    supported: number;
+    unsupported: number;
+}
+/**
+ * Inspects body-level inline `w:sdt` controls without changing the package.
+ * Structural controls such as TOC/INDEX are left to their dedicated
+ * importers, so they are not reported as unsupported form controls here.
+ */
+export declare function inspectDocxContentControls(document: Document): DocxContentControlInspection;
+/**
+ * Moves the bounded inline control body into ordinary runs and surrounds it
+ * with text markers. Mammoth can then convert the runs normally; the markers
+ * are wrapped back into an editable HTML node after conversion.
+ */
+export declare function markDocxContentControls(document: Document): ImportedDocxContentControlMarkers;
+export declare function applyImportedDocxContentControlMarkers(document: Document, markers: ImportedDocxContentControlMarkers): void;
+export declare function hasImportedDocxContentControlMarkers(markers: ImportedDocxContentControlMarkers): boolean;

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

@@ -3,10 +3,10 @@ import { type ImportedDocxCaptionMarkers } from './work-docx-caption-import';
 import { type ImportedDocxChangeMarkers } from './work-docx-change-import';
 import { type ImportedDocxCitationMarkers } from './work-docx-citation-import';
 import { type ImportedDocxCommentMarkers } from './work-docx-comment-import';
+import { type ImportedDocxContentControlMarkers } from './work-docx-content-control-import';
 import { type ImportedDocxEquationMarkers } from './work-docx-equation-import';
 import { type ImportedDocxFieldMarkers } from './work-docx-field-import';
 import { type ImportedDocxImageLayoutMarkers } from './work-docx-image-layout-import';
-import { type ImportedDocxTextBoxMarkers } from './work-docx-text-box-import';
 import { type ImportedDocxIndexMarkers } from './work-docx-index-import';
 import { type ImportedDocxListMarkers } from './work-docx-list-import';
 import { type ImportedDocxNumberingChangeMarkers } from './work-docx-numbering-change-import';
@@ -25,6 +25,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'>;
@@ -48,6 +49,7 @@ export interface PreparedDocxImport {
     numberingChangeMarkers: ImportedDocxNumberingChangeMarkers;
     imageLayoutMarkers: ImportedDocxImageLayoutMarkers;
     textBoxMarkers: ImportedDocxTextBoxMarkers;
+    contentControlMarkers: ImportedDocxContentControlMarkers;
     paragraphIdentityMarkers: ImportedDocxParagraphIdentityMarkers;
     paragraphFormattingChangeMarkers: ImportedDocxParagraphFormattingChangeMarkers;
     paragraphAlignmentMarkers: ImportedDocxParagraphAlignmentMarkers;
@@ -66,6 +68,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, textBoxMarkers?: ImportedDocxTextBoxMarkers): 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, contentControlMarkers?: ImportedDocxContentControlMarkers): string;
 export declare function readDocxLayout(buffer: ArrayBuffer): Promise<ImportedDocumentLayout>;
 export {};

package/dist/styles.css

@@ -12938,6 +12938,131 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   padding: 0;
 }
 
+.work-document-content-control {
+  --work-document-content-control-color: var(--a3s-accent);
+  --work-document-content-control-appearance: boundingBox;
+  border: 1px solid
+    color-mix(in srgb,
+      var(--work-document-content-control-color) 62%,
+      transparent);
+  background: color-mix(in srgb,
+    var(--work-document-content-control-color) 8%,
+    transparent);
+  -webkit-box-decoration-break: clone;
+  box-decoration-break: clone;
+  border-radius: 3px;
+  min-width: 1.25em;
+  padding: 0 .18em;
+  transition: background-color .12s, border-color .12s;
+  display: inline-block;
+  position: relative;
+}
+
+.work-document-content-control:hover, .work-document-content-control.ProseMirror-selectednode {
+  border-color: var(--work-document-content-control-color);
+  background: color-mix(in srgb,
+    var(--work-document-content-control-color) 14%,
+    transparent);
+}
+
+.work-document-content-control[data-content-control-appearance="hidden"] {
+  background: none;
+  border-color: #0000;
+}
+
+.work-document-content-control[data-content-control-appearance="tags"]:before {
+  content: attr(data-content-control-label);
+  max-width: 18em;
+  color: var(--work-document-content-control-color);
+  white-space: nowrap;
+  pointer-events: none;
+  font-size: .68em;
+  line-height: 1;
+  position: absolute;
+  top: -1.1em;
+  left: -1px;
+  overflow: hidden;
+}
+
+.work-document-content-control[data-content-control-lock="contentLocked"], .work-document-content-control[data-content-control-lock="sdtContentLocked"], .work-document-content-control[data-content-control-lock="sdtLocked"] {
+  background: color-mix(in srgb,
+    var(--work-document-content-control-color) 5%,
+    transparent);
+}
+
+.work-document-content-control:empty:after {
+  content: "输入内容";
+  color: color-mix(in srgb, currentColor 48%, transparent);
+  pointer-events: none;
+}
+
+.work-document-content-control[contenteditable="false"] {
+  cursor: not-allowed;
+}
+
+@media print {
+  .work-document-content-control {
+    background: none;
+    border-color: #0000;
+  }
+
+  .work-document-content-control[data-content-control-appearance="tags"]:before {
+    display: none;
+  }
+}
+
+.work-document-content-control-dialog-fields, .work-document-content-control-dialog-selects, .work-document-content-control-dialog-options {
+  gap: 12px;
+  display: grid;
+}
+
+.work-document-content-control-dialog-fields, .work-document-content-control-dialog-selects {
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+}
+
+.work-document-content-control-dialog-fields label, .work-document-content-control-dialog-selects label, .work-document-content-control-dialog-field, .work-document-content-control-color {
+  color: var(--a3s-text-muted);
+  gap: 5px;
+  font-size: 12px;
+  display: grid;
+}
+
+.work-document-content-control-dialog-options {
+  grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
+  align-items: center;
+  margin-top: 12px;
+}
+
+.work-document-content-control-color {
+  grid-template-columns: auto auto 1fr;
+  align-items: center;
+}
+
+.work-document-content-control-color input[type="color"] {
+  border: 1px solid var(--a3s-line);
+  background: none;
+  border-radius: 5px;
+  width: 28px;
+  height: 28px;
+  padding: 2px;
+}
+
+.work-document-content-control-color-reset {
+  color: var(--a3s-accent);
+  cursor: pointer;
+  font: inherit;
+  background: none;
+  border: 0;
+  justify-self: start;
+  font-size: 11px;
+}
+
+@media (width <= 640px) {
+  .work-document-content-control-dialog-fields, .work-document-content-control-dialog-selects, .work-document-content-control-dialog-options {
+    grid-template-columns: minmax(0, 1fr);
+  }
+}
+
 .work-document-table-of-contents {
   box-sizing: border-box;
   border: 1px solid color-mix(in srgb, var(--a3s-line) 82%, #8aa7d8);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.46.0",
+  "version": "0.48.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -106,6 +106,7 @@
     "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:document-content-control": "playwright test visual-tests/document-content-control.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",
@@ -139,10 +140,12 @@
     "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-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": "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-content-controls-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-content-controls-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:writer-content-control": "bun run test:e2e:fixtures && A3S_TEST_SUITE=tests/e2e/word-content-controls-phone.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:writer-content-control:check": "a3s-test check tests/e2e/word-content-controls-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",