@a3s-lab/office 0.28.0 → 0.29.0

package/dist/8715.js

@@ -1,4 +1,4 @@
-import { createOfficeId as createWorkId, directChild, attribute } from "./5184.js";
+import { createOfficeId as createWorkId, directChild, attribute } from "./4121.js";
 const CELL_REFERENCE = /\$?([A-Z]{1,3})\$?([1-9]\d*)/i;
 const CELL_OR_RANGE = new RegExp(`^${CELL_REFERENCE.source}(?::${CELL_REFERENCE.source})?$`, 'i');
 const COLUMN_RANGE = /^\$?([A-Z]{1,3}):\$?([A-Z]{1,3})$/i;

package/dist/core.js

@@ -3,7 +3,7 @@ export { AGENT_PROPOSAL_PROTOCOL, OFFICE_NOTIFICATION_EVENT, createAgentProposal
 export { DOCUMENT_SNAPSHOT_MEDIA_TYPE, DOCUMENT_SNAPSHOT_SCHEMA, DOCUMENT_SNAPSHOT_VERSION, DOCUMENT_SOURCE_MEDIA_TYPE, DOCUMENT_SOURCE_SCHEMA, DOCUMENT_SOURCE_VERSION, OFFICE_COLLABORATION_DEFAULT_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_MAX_TRANSPORT_PAYLOAD_BYTES, OFFICE_COLLABORATION_PRESENCE_FIELD, OFFICE_FILE_ACCEPT, applyDocumentSource, artifactExtension, artifactExtension as workArtifactExtension, artifactKindLabel, artifactKindLabel as workArtifactKindLabel, createArtifactBlob, createOfficeCollaborationPresence, createOfficeCollaborationTransportBinding, createPdfCollaborationContent, decodeDocumentSnapshot, defaultPptxRuntimeUrl, downloadArtifact, downloadArtifactPdf, encodeDocumentSnapshot, forgetSourceBlob, importOfficeFile, officeKindForFile, pdfPagesForExport, projectDocumentSource, readSourceBlob, registerSourceBlob } from "./4104.js";
 export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
 export { assertPdfCollaborationSource, createOfficePdfCollaborationBinding, initializeOfficePdfCollaboration, readOfficePdfCollaboration, readOfficePdfCollaborationSource, replaceOfficePdfCollaboration } from "./3818.js";
-export { createArtifact, createOfficeId, officeTemplates } from "./5184.js";
+export { createArtifact, createOfficeId, officeTemplates } from "./4121.js";
 export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./6282.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";

package/dist/index.js

@@ -6,7 +6,7 @@ export { DOCUMENT_SNAPSHOT_MEDIA_TYPE, DOCUMENT_SNAPSHOT_SCHEMA, DOCUMENT_SOURCE
 export { DocumentEditor, MarkdownEditor, PDF_EVIDENCE_COORDINATE_BASIS, PdfViewer, PresentationEditor, SpreadsheetEditor, defaultDocumentArabicLayoutFontUrl, defaultDocumentHebrewLayoutFontUrl, defaultDocumentLatinLayoutFontUrl, defaultDocumentLayoutFontUrl, defaultDocumentLayoutFonts, defaultOfficeKernelWasmUrl, defaultPdfiumWasmUrl, preloadOfficeEditor } from "./432.js";
 export { OFFICE_COLLABORATION_NAMESPACE, OFFICE_COLLABORATION_PROTOCOL, OfficeCollaborationError, createOfficeCollaborationSession, readOfficeCollaborationMetadata } from "./9787.js";
 export { assertPdfCollaborationSource, createOfficePdfCollaborationBinding, initializeOfficePdfCollaboration, readOfficePdfCollaboration, readOfficePdfCollaborationSource, replaceOfficePdfCollaboration } from "./3818.js";
-export { createArtifact, createOfficeId, officeTemplates } from "./5184.js";
+export { createArtifact, createOfficeId, officeTemplates } from "./4121.js";
 export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./6282.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";

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

@@ -333,6 +333,15 @@ export declare const documentCommandCatalog: {
             readonly editor: readonly ["Mod-Shift-h"];
         };
     };
+    readonly runBorder: {
+        readonly id: "font.runBorder";
+        readonly label: "字符边框";
+        readonly location: {
+            readonly area: "ribbon";
+            readonly tab: "home";
+            readonly group: "font";
+        };
+    };
     readonly clearFormatting: {
         readonly id: "font.clearFormatting";
         readonly label: "清除格式";

package/dist/internal/features/work/editors/document-font-dialog-model.d.ts

@@ -1,6 +1,7 @@
 import type { Editor } from '@tiptap/core';
 import { type WorkDocumentEmphasisMark } from '../work-document-emphasis';
 import { type DocumentFontDialogScriptFontPatch, type DocumentFontFamilySource } from './document-font-dialog-script-font-model';
+import { type DocumentFontDialogRunBorderDraft, type DocumentFontDialogRunBorderPatch, type DocumentFontDialogRunBorderSource } from './document-font-dialog-run-border-model';
 export type { DocumentFontFamilySource } from './document-font-dialog-script-font-model';
 export type DocumentCharacterSpacingMode = 'condensed' | 'expanded' | 'mixed' | 'normal';
 export type DocumentCharacterPositionMode = 'lowered' | 'mixed' | 'normal' | 'raised';
@@ -47,6 +48,7 @@ export interface DocumentFontDialogSource {
         mixed: boolean;
         value: boolean | null;
     };
+    runBorder: DocumentFontDialogRunBorderSource;
     latinFont: DocumentFontFamilySource;
     eastAsiaFont: DocumentFontFamilySource;
     complexScriptFont: DocumentFontFamilySource;
@@ -55,7 +57,7 @@ export interface DocumentFontDialogSource {
     previewText: string;
     selectedCharacters: number;
 }
-export interface DocumentFontDialogDraft {
+export interface DocumentFontDialogDraft extends DocumentFontDialogRunBorderDraft {
     characterScaleMode: DocumentCharacterScaleMode;
     characterScalePercent: string;
     characterPositionMode: DocumentCharacterPositionMode;
@@ -74,7 +76,7 @@ export interface DocumentFontDialogDraft {
     eastAsiaFont: string;
     complexScriptFont: string;
 }
-export interface DocumentFontDialogPatch extends DocumentFontDialogScriptFontPatch {
+export interface DocumentFontDialogPatch extends DocumentFontDialogScriptFontPatch, DocumentFontDialogRunBorderPatch {
     characterScalePercent?: number;
     characterPositionHalfPoints?: number;
     characterSpacingTwips?: number;
@@ -98,6 +100,7 @@ export interface DocumentFontDialogTouched {
     legacyTextShadow: boolean;
     legacyTextEmboss: boolean;
     legacyTextImprint: boolean;
+    runBorder: boolean;
     kerning: boolean;
     latinFont: boolean;
 }

package/dist/internal/features/work/editors/document-font-dialog-run-border-model.d.ts

@@ -0,0 +1,24 @@
+import { type DocumentRunBorder, type DocumentRunBorderStyle } from '../work-document-run-border';
+export type DocumentFontDialogRunBorderMode = 'inherit' | 'mixed' | 'none' | 'value';
+export interface DocumentFontDialogRunBorderSource {
+    mixed: boolean;
+    value: DocumentRunBorder | null;
+}
+export interface DocumentFontDialogRunBorderDraft {
+    runBorderMode: DocumentFontDialogRunBorderMode;
+    runBorderStyle: DocumentRunBorderStyle;
+    runBorderColor: 'auto' | `#${string}`;
+    runBorderWidthPoints: string;
+    runBorderSpacingPoints: string;
+    runBorderShadow: boolean;
+    runBorderFrame: boolean;
+}
+export interface DocumentFontDialogRunBorderPatch {
+    runBorder?: DocumentRunBorder | null;
+}
+export declare function addDocumentFontDialogRunBorderValue(values: Map<string, DocumentRunBorder | null>, source: unknown): void;
+export declare function selectedDocumentFontDialogRunBorderValue(values: ReadonlyMap<string, DocumentRunBorder | null>): DocumentFontDialogRunBorderSource;
+export declare function createDocumentFontDialogRunBorderDraft(source: DocumentFontDialogRunBorderSource): DocumentFontDialogRunBorderDraft;
+export declare function documentFontDialogRunBorderDraftError(draft: DocumentFontDialogRunBorderDraft): string | null;
+export declare function documentFontDialogRunBorderPatch(source: DocumentFontDialogRunBorderSource, draft: DocumentFontDialogRunBorderDraft, touched: boolean): DocumentFontDialogRunBorderPatch;
+export declare function documentFontDialogRunBorderFromDraft(source: DocumentFontDialogRunBorderSource, draft: DocumentFontDialogRunBorderDraft): DocumentRunBorder | null;

package/dist/internal/features/work/editors/document-font-dialog-run-border-section.d.ts

@@ -0,0 +1,10 @@
+import type { CSSProperties } from 'react';
+import { type DocumentFontDialogRunBorderDraft, type DocumentFontDialogRunBorderSource } from './document-font-dialog-run-border-model';
+export declare function DocumentFontDialogRunBorderSection({ source, draft, touched, onDraftChange, onTouched, }: {
+    source: DocumentFontDialogRunBorderSource;
+    draft: DocumentFontDialogRunBorderDraft;
+    touched: boolean;
+    onDraftChange: (patch: Partial<DocumentFontDialogRunBorderDraft>) => void;
+    onTouched: () => void;
+}): import("react").JSX.Element;
+export declare function documentFontDialogRunBorderPreviewStyle(source: DocumentFontDialogRunBorderSource, draft: DocumentFontDialogRunBorderDraft): CSSProperties;

package/dist/internal/features/work/work-document-character-formatting.d.ts

@@ -1,6 +1,7 @@
 import { Extension, type Editor } from '@tiptap/core';
 import { type WorkDocumentEmphasisMark } from './work-document-emphasis';
 import { type WorkDocumentTextCase } from './work-document-text-case';
+import { type DocumentRunBorder } from './work-document-run-border';
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         documentCharacterFormatting: {
@@ -18,6 +19,9 @@ declare module '@tiptap/core' {
             toggleDocumentHiddenText: () => ReturnType;
             setDocumentTextCase: (textCase: WorkDocumentTextCase) => ReturnType;
             toggleDocumentTextCase: (textCase: Exclude<WorkDocumentTextCase, 'none'>) => ReturnType;
+            setDocumentRunBorder: (border: DocumentRunBorder) => ReturnType;
+            unsetDocumentRunBorder: () => ReturnType;
+            toggleDocumentRunBorder: () => ReturnType;
         };
     }
 }

package/dist/internal/features/work/work-document-format-changes.d.ts

@@ -35,6 +35,7 @@ export declare function importedDocumentCharacterFormatting(formatting: {
     legacyTextShadow?: boolean;
     legacyTextEmboss?: boolean;
     legacyTextImprint?: boolean;
+    runBorder?: string;
     wordLineHeightFactor?: number;
     wordSnapToGrid?: boolean;
     fontSize?: number;

package/dist/internal/features/work/work-document-run-border.d.ts

@@ -0,0 +1,11 @@
+import { type DocumentParagraphBorder, type DocumentParagraphBorderStyle } from './work-document-paragraph-borders';
+export declare const DOCUMENT_RUN_BORDER_ATTRIBUTE = "data-office-run-border";
+export type DocumentRunBorder = DocumentParagraphBorder;
+export type DocumentRunBorderStyle = DocumentParagraphBorderStyle;
+export declare const DOCUMENT_RUN_BORDER_STYLES: readonly DocumentRunBorderStyle[];
+export declare function normalizeDocumentRunBorder(source: unknown): DocumentRunBorder | null;
+export declare function parseDocumentRunBorder(source: unknown): DocumentRunBorder | null;
+export declare function serializeDocumentRunBorder(source: unknown): string | undefined;
+export declare function parseDocumentRunBorderElement(element: HTMLElement): DocumentRunBorder | null;
+export declare function documentRunBorderDomAttributes(source: unknown): Record<string, string>;
+export declare function documentRunBorderIsVisible(source: unknown): boolean;

package/dist/internal/features/work/work-document-word-line-metrics.d.ts

@@ -13,6 +13,7 @@ declare module '@tiptap/extension-text-style' {
         legacyTextShadow?: boolean | null;
         legacyTextEmboss?: boolean | null;
         legacyTextImprint?: boolean | null;
+        runBorder?: string | null;
         kerningThresholdHalfPoints?: number | null;
         scriptFonts?: string | null;
         scriptFontSlot?: WorkDocumentScriptFontSlot | null;

package/dist/internal/features/work/work-docx-run-border-diagnostics.d.ts

@@ -0,0 +1,3 @@
+import { type OoxmlPackage } from './work-ooxml-package';
+import type { WorkCompatibilityIssue } from './work-types';
+export declare function diagnoseDocxRunBorders(archive: OoxmlPackage, document: Document): Promise<WorkCompatibilityIssue[]>;

package/dist/internal/features/work/work-docx-run-border-export.d.ts

@@ -0,0 +1,17 @@
+import type { IRunOptions } from 'docx';
+import { type DocumentRunBorder } from './work-document-run-border';
+export interface DocxRunBorderPatch {
+    marker: string;
+    border: DocumentRunBorder;
+}
+export declare class DocxRunBorderPatchCollector {
+    readonly patches: DocxRunBorderPatch[];
+    private nextMarker;
+    private readonly usedColors;
+    constructor(sourceHtml: string);
+    marker(source: unknown): string | null;
+    hasMarker(value: string | null | undefined): value is string;
+}
+export declare function documentRunBorderDocxOptions(source: unknown, collector: DocxRunBorderPatchCollector): Pick<IRunOptions, 'border'>;
+export declare function patchDocxRunBorders(buffer: ArrayBuffer, patches: readonly DocxRunBorderPatch[]): Promise<ArrayBuffer>;
+export declare function setDocxRunBorderAttributes(document: Document, element: Element, border: DocumentRunBorder): void;

package/dist/internal/features/work/work-docx-run-border.d.ts

@@ -0,0 +1,20 @@
+import type { DocumentRunBorder } from './work-document-run-border';
+import { type DocxThemeSource } from './work-docx-theme';
+export type DocxRunBorderInspection = {
+    status: 'absent';
+    spoofedCount: number;
+} | {
+    status: 'invalid';
+    spoofedCount: number;
+} | {
+    status: 'valid';
+    value: DocumentRunBorder;
+    spoofedCount: number;
+};
+export interface ResolvedDocxRunBorder {
+    border: DocumentRunBorder | undefined;
+    invalidCount: number;
+    spoofedCount: number;
+}
+export declare function inspectDocxRunBorder(properties: Element | null | undefined, themeSource?: DocxThemeSource): DocxRunBorderInspection;
+export declare function resolveDocxRunBorder(propertySources: readonly Element[], themeSource?: DocxThemeSource): ResolvedDocxRunBorder;

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

@@ -7,6 +7,7 @@ import { type WorkDocumentTextCase } from './work-document-text-case';
 import { type WorkDocumentUnderlineFormatting } from './work-document-underline';
 import { type WorkDocumentStrikeFormatting } from './work-document-strike';
 import { type WorkDocumentScriptFontSlot, type WorkDocumentScriptFonts } from './work-document-script-fonts';
+import { type DocumentRunBorder } from './work-document-run-border';
 export interface ImportedDocxRunFormatting {
     bold?: boolean;
     italic?: boolean;
@@ -35,6 +36,7 @@ export interface ImportedDocxRunFormatting {
     themeColor?: DocxThemeColorReference;
     themeFill?: DocxThemeColorReference;
     textCase?: WorkDocumentTextCase;
+    runBorder?: DocumentRunBorder;
 }
 export interface ImportedDocxRunFormattingMarker {
     startMarker: string;

package/dist/styles.css

@@ -9718,6 +9718,33 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   display: grid;
 }
 
+.work-document-font-dialog-run-border {
+  border: 1px solid color-mix(in srgb, var(--a3s-line) 78%, transparent);
+  background: var(--a3s-panel-soft);
+  border-radius: 8px;
+  grid-column: 1 / -1;
+  grid-template-columns: repeat(3, minmax(0, 1fr));
+  gap: 10px 14px;
+  min-width: 0;
+  margin: 0;
+  padding: 10px 12px 12px;
+  display: grid;
+}
+
+.work-document-font-dialog-run-border > legend {
+  color: var(--a3s-muted);
+  padding: 0 4px;
+  font-size: 11px;
+  font-weight: 700;
+}
+
+.work-document-font-dialog-run-border-effects {
+  align-items: end;
+  gap: 16px;
+  min-height: 32px;
+  display: flex;
+}
+
 .work-document-font-dialog-field > .work-office-select, .work-document-font-dialog-field .work-office-number-field, .work-document-font-dialog-field button[role="combobox"] {
   width: 100%;
 }
@@ -9788,6 +9815,10 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
     grid-template-columns: repeat(2, minmax(0, 1fr));
   }
 
+  .work-document-font-dialog-run-border {
+    grid-template-columns: minmax(0, 1fr);
+  }
+
   .work-document-font-dialog-preview {
     min-height: 88px;
   }

package/docs/latest/en/browser-editor-architecture.md

@@ -699,6 +699,28 @@ an empty nested container. The four effects change paint but not advances, so
 eligible paragraphs remain on Worker/WASM layout and the browser/PDF CSS
 projection stays an explicitly bounded approximation.
 
+Native character borders are resolved as one validated TextStyle value before
+layout eligibility, DOM serialization, and DOCX export. The closed model
+accepts 25 visible `w:bdr` line styles plus `nil` and `none`, direct or resolved
+theme colors with tint/shade identity, bounded eighth-point width, point
+spacing, shadow, and frame fields. Duplicate, misplaced, art-style,
+namespace-spoofed, child- or text-bearing, extra-attribute, out-of-range, and
+unresolved-theme leaves normalize to an explicit `nil` reset and emit a
+compatibility diagnostic instead of enabling untrusted paint or reviving
+inherited formatting.
+
+The canonical DOM mark stores semantic JSON in `data-office-run-border`; its
+CSS projection uses four-edge border paint, padding, shadow, and
+`box-decoration-break: clone`. A visible border changes inline geometry, so
+the containing paragraph deliberately uses browser-authoritative measurement.
+Explicit `nil` and `none` add no geometry and remain eligible for Worker/WASM
+shaping. The DOCX generator allocates a collision-checked temporary border
+color only inside generated runs, then patches the body, page chrome, and note
+parts to exact `w:bdr` attributes before formatting-change snapshots are
+written. This keeps direct/style inheritance and prior `w:rPrChange` values
+exact while treating browser and PDF line-style paint as a bounded visual
+approximation.
+
 Tables, images, code blocks, and other complex content use explicit
 format-specific measurement. Top-level tables are row flows; eligible rows can
 additionally expose synchronized direct-cell block fragments. Ordered and bullet

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -90,6 +90,7 @@
     "playground:visual:document-emphasis": "playwright test visual-tests/document-emphasis.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-hidden-text": "playwright test visual-tests/document-hidden-text.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-legacy-text-effects": "playwright test visual-tests/document-legacy-text-effects.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:document-run-border": "playwright test visual-tests/document-run-border.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-kerning": "playwright test visual-tests/document-kerning.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-character-scale": "playwright test visual-tests/document-character-scale.functional.spec.ts --config playwright.config.ts",
     "playground:visual:document-character-position": "playwright test visual-tests/document-character-position.functional.spec.ts --config playwright.config.ts",
@@ -201,6 +202,8 @@
     "test:e2e:writer-hidden-text:check": "a3s-test check tests/e2e/word-hidden-text.acl --json",
     "test:e2e:writer-legacy-text-effects": "A3S_TEST_SUITE=tests/e2e/word-legacy-text-effects.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:writer-legacy-text-effects:check": "a3s-test check tests/e2e/word-legacy-text-effects.acl --json",
+    "test:e2e:writer-run-border": "A3S_TEST_SUITE=tests/e2e/word-run-border.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:writer-run-border:check": "a3s-test check tests/e2e/word-run-border.acl --json",
     "test:e2e:writer-kerning": "A3S_TEST_SUITE=tests/e2e/word-kerning.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:writer-kerning:check": "a3s-test check tests/e2e/word-kerning.acl --json",
     "test:e2e:writer-character-scale": "A3S_TEST_SUITE=tests/e2e/word-character-scale.acl bash scripts/run-a3s-test-web-gate.sh",