@a3s-lab/office 0.28.0 → 0.29.0

package/README.md

@@ -110,7 +110,7 @@ baseline rather than one specific release.
 
 | Capability | A3S Office today | Traditional Office baseline |
 | --- | --- | --- |
-| Text, paragraphs, lists, and styles | **Supported** — structured editing, independent native ASCII, high ANSI, East Asian, and complex-script font slots with direct/theme identity, native all-caps and small-caps effects, exact DOCX character scale plus signed spacing, half-point kerning thresholds, all five native East Asian emphasis marks, native hidden text with explicit visible resets, four independent native outline/shadow/emboss/imprint effects with conflict-safe authoring, and baseline position in one advanced font dialog, all 18 native DOCX underline values with direct or theme color identity, independent native single/double strikethrough with explicit resets, formatting revisions, clipboard, format painter, and undo/redo | Mature authoring with a broader long-tail style and typography catalog |
+| Text, paragraphs, lists, and styles | **Supported** — structured editing, independent native ASCII, high ANSI, East Asian, and complex-script font slots with direct/theme identity, native all-caps and small-caps effects, exact DOCX character scale plus signed spacing, half-point kerning thresholds, all five native East Asian emphasis marks, native hidden text with explicit visible resets, native character borders with 25 visible line styles plus `nil` and `none`, direct or theme color, width, spacing, shadow, and frame semantics, four independent native outline/shadow/emboss/imprint effects with conflict-safe authoring, and baseline position in one advanced font dialog, all 18 native DOCX underline values with direct or theme color identity, independent native single/double strikethrough with explicit resets, formatting revisions, clipboard, format painter, and undo/redo | Mature authoring with a broader long-tail style and typography catalog |
 | Page layout and rendering | **Partial** — sections, margins, page size, columns, headers/footers, fields, and live pagination | Desktop-grade pagination, print layout, and vector output |
 | Tables, pictures, and equations | **Partial** — rich table geometry, floating pictures, crop/wrap, and structured OMML | Broader drawings, text boxes, charts, WordArt, and SmartArt |
 | Comments, revisions, and collaboration | **Partial** — comments, suggestions, text/format revisions, decisions, Yjs presence, and host relay contracts | Full revision families plus integrated sharing and review services |
@@ -732,6 +732,31 @@ model. CSS provides bounded browser and PDF paint projections while eligible
 paragraphs remain on the Worker/WASM layout path. The Playground's **文字效果**
 template demonstrates all four effects and the conflict-safe transition.
 
+Native Writer character borders retain all 25 visible WordprocessingML
+`w:bdr` line styles plus explicit `nil` and `none` resets. The typed model keeps
+direct or theme colors with tint and shade, widths from 2 through 96
+eighth-points, text spacing from 0 through 31 points, and explicit shadow and
+frame flags. The Home Font group exposes a direct Character Border toggle, and
+the shared `Cmd/Ctrl+D` Advanced Font Settings dialog distinguishes mixed,
+Follow style, explicit no-border, and editable border states. Line style,
+color, width, spacing, shadow, and frame changes apply through one transaction
+and one Undo record; Format Painter uses the same mark. Traditional Office
+defines no dedicated shortcut for this command, so A3S Office does not invent
+one.
+
+Document defaults, paragraph and character styles, body text, headers,
+footers, footnotes, endnotes, formatting revisions, strict or transitional
+DOCX import, exact export, and reopen share the model. Malformed, duplicated,
+misplaced, namespace-spoofed, child- or text-bearing, extra-attribute,
+art-style, out-of-range, and unresolved-theme input fails closed. The DOM uses
+`data-office-run-border`; CSS renders every edge with bounded line-style,
+padding, shadow, and cloned-fragment projections. Visible character borders use
+browser-authoritative line measurement because border and padding alter inline
+geometry, while explicit `nil` and `none` remain eligible for Worker/WASM
+layout. Browser and PDF paint are bounded visual approximations; the OOXML
+semantics remain exact. The Playground's **字符边框** template exercises the
+complete authoring and one-step Undo path.
+
 Supported native OMML equations now survive as bounded structured objects in
 the document body, headers, footers, footnotes, and endnotes. Inline and display
 math, Unicode runs with literal/normal-text semantics, math script/style,
@@ -1432,6 +1457,7 @@ without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.29.0 documentation](https://a3s-lab.github.io/Office/docs/0.29.0/)
 - [A3S Office 0.28.0 documentation](https://a3s-lab.github.io/Office/docs/0.28.0/)
 - [A3S Office 0.27.0 documentation](https://a3s-lab.github.io/Office/docs/0.27.0/)
 - [A3S Office 0.26.0 documentation](https://a3s-lab.github.io/Office/docs/0.26.0/)

package/dist/0~1403.js

@@ -1,4 +1,4 @@
-import { createOfficeId as createWorkId } from "./5184.js";
+import { createOfficeId as createWorkId } from "./4121.js";
 function expandPresentationGroupSelection(elements, selectedIds) {
     const byId = new Map();
     const membersByGroupId = new Map();

package/dist/0~4980.js

@@ -1,6 +1,6 @@
 import jszip from "jszip";
 import { documentNoteKey } from "./6282.js";
-import { directChild, xmlNamespacePrefix, attribute, parseXml } from "./5184.js";
+import { directChild, xmlNamespacePrefix, attribute, parseXml } from "./4121.js";
 import { DEFAULT_DOCUMENT_PAGE_COLOR, normalizeDocumentPageColor } from "./0~work-document-page-color.js";
 const MAX_NATIVE_ID = 2147483647;
 const MIN_NATIVE_COMMENT_ID = -2147483648;

package/dist/0~5093.js

@@ -1,6 +1,6 @@
-import { descendants, directChildren as work_ooxml_package_directChildren, xmlNamespacePrefix, directChild, attribute as work_ooxml_package_attribute, childPath } from "./5184.js";
+import { DOCUMENT_PARAGRAPH_BORDER_STYLES, normalizeDocumentParagraphBorders as work_document_paragraph_borders_normalizeDocumentParagraphBorders, DOCUMENT_PARAGRAPH_BORDER_EDGES, documentRunBorderDomAttributes, normalizeDocumentParagraphBorder, normalizeDocumentRunBorder, serializeDocumentRunBorder, descendants, attribute as work_ooxml_package_attribute, serializeDocxThemeReference, directChildren as work_ooxml_package_directChildren, xmlNamespacePrefix, documentParagraphBordersDomAttributes, directChild, childPath } from "./4121.js";
 import { docxThemeFont, XML_NAMESPACE as work_docx_settings_xml_XML_NAMESPACE, XMLNS_NAMESPACE as work_docx_settings_xml_XMLNS_NAMESPACE, STRICT_WORDPROCESSING_NAMESPACE, docxCharacterSpacingTwipsFromProperties, parseBoundedDocxInteger, xmlAttributeLocalName, docxCharacterScalePercentFromProperties, resolveDocxEmphasisMark, docxCharacterPositionHalfPointsFromProperties, docxThemeColor, parseDocxParagraphDefaultCollapsed, resolveDocxKerningThresholdHalfPoints, resolveDocxThemeResolver as work_docx_theme_resolveDocxThemeResolver, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, parseDocxTwipsMeasure } from "./0~7043.js";
-import { normalizeDocumentEmphasisMark, documentWordLineHeightFactor, normalizeDocumentPageBorders, normalizeDocumentParagraphBorder, documentCharacterPositionDomAttributes, DOCUMENT_PAGE_BORDER_EDGES, normalizeDocumentTabStops, documentTextCaseFromWordFlags, DOCUMENT_PARAGRAPH_SHADING_PATTERNS, documentStrikeDomAttributes, documentAutoLineHeight, documentScriptFontFallbackSlots, normalizeDocumentUnderlineColor, documentScriptFontsDomAttributes, documentKerningDomAttributes, documentCharacterScaleDomAttributes, documentParagraphShadingDomAttributes, serializeDocxThemeReference, documentParagraphBordersDomAttributes, normalizeDocumentScriptFontHint, serializeDocumentParagraphFormatting, normalizeDocumentPaperSource, documentEquationText, normalizeDocumentScriptFonts, documentLegacyTextEffectsDomAttributes, documentLegacyTextEffectsConflict, DOCUMENT_PARAGRAPH_BORDER_STYLES, normalizeDocumentParagraphBorders as work_document_paragraph_borders_normalizeDocumentParagraphBorders, DOCUMENT_PARAGRAPH_BORDER_EDGES, normalizeDocumentParagraphIndent, documentScriptFontFamily, normalizeDocumentEquation, normalizeDocumentThemeFont, documentCharacterSpacingDomAttributes, renderDocumentAutoLineHeight, documentUnderlineDomAttributes, normalizeDocumentUnderlineStyle, normalizeDocumentFontName, applyDocumentTextCaseStyle, documentHiddenTextDomAttributes, importedDocumentCharacterFormatting, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, createDocumentEquationElement, normalizeDocumentPageGeometry, serializeDocumentTabStops, documentEmphasisMarkDomAttributes, normalizeDocumentPageMargins, documentScriptFontSegments } from "./6282.js";
+import { normalizeDocumentEmphasisMark, documentWordLineHeightFactor, normalizeDocumentPageBorders, documentCharacterPositionDomAttributes, DOCUMENT_PAGE_BORDER_EDGES, normalizeDocumentTabStops, documentTextCaseFromWordFlags, DOCUMENT_PARAGRAPH_SHADING_PATTERNS, documentStrikeDomAttributes, documentAutoLineHeight, documentScriptFontFallbackSlots, normalizeDocumentUnderlineColor, documentScriptFontsDomAttributes, documentKerningDomAttributes, documentCharacterScaleDomAttributes, documentParagraphShadingDomAttributes, normalizeDocumentScriptFontHint, serializeDocumentParagraphFormatting, normalizeDocumentPaperSource, documentEquationText, normalizeDocumentScriptFonts, documentLegacyTextEffectsDomAttributes, documentLegacyTextEffectsConflict, documentCharacterSpacingDomAttributes, normalizeDocumentParagraphIndent, documentScriptFontFamily, normalizeDocumentThemeFont, normalizeDocumentEquation, renderDocumentAutoLineHeight, documentUnderlineDomAttributes, normalizeDocumentUnderlineStyle, normalizeDocumentFontName, applyDocumentTextCaseStyle, documentHiddenTextDomAttributes, importedDocumentCharacterFormatting, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, createDocumentEquationElement, normalizeDocumentPageGeometry, serializeDocumentTabStops, documentEmphasisMarkDomAttributes, normalizeDocumentPageMargins, documentScriptFontSegments } from "./6282.js";
 function docxCaptionSequenceKind(instruction) {
     const identifier = /^\s*SEQ\s+([^\s\\]+)/i.exec(instruction)?.[1]?.toLowerCase();
     if (!identifier) return null;
@@ -4907,6 +4907,57 @@ function textNodes(root) {
     while(walker.nextNode())nodes.push(walker.currentNode);
     return nodes;
 }
+function inspectDocxRunBorder(properties, themeSource) {
+    return inspectDocxRunBorderWithTheme(properties, work_docx_theme_resolveDocxThemeResolver(themeSource));
+}
+function resolveDocxRunBorder(propertySources, themeSource) {
+    const theme = work_docx_theme_resolveDocxThemeResolver(themeSource);
+    let border;
+    let invalidCount = 0;
+    let spoofedCount = 0;
+    for (const properties of propertySources){
+        const inspection = inspectDocxRunBorderWithTheme(properties, theme);
+        spoofedCount += inspection.spoofedCount;
+        if ('valid' === inspection.status) border = inspection.value;
+        else if ('invalid' === inspection.status) {
+            invalidCount += 1;
+            border = {
+                style: 'nil'
+            };
+        }
+    }
+    return {
+        border,
+        invalidCount,
+        spoofedCount
+    };
+}
+function inspectDocxRunBorderWithTheme(properties, theme) {
+    if (!properties) return {
+        status: 'absent',
+        spoofedCount: 0
+    };
+    const matches = work_ooxml_package_directChildren(properties, 'bdr');
+    if (!matches.length) return {
+        status: 'absent',
+        spoofedCount: 0
+    };
+    const native = matches.filter((element)=>element.namespaceURI === properties.namespaceURI);
+    const spoofedCount = matches.length - native.length;
+    if (1 !== matches.length || 1 !== native.length) return {
+        status: 'invalid',
+        spoofedCount
+    };
+    const parsed = normalizeDocumentRunBorder(parseDocxBorderElement(native[0], theme));
+    return parsed ? {
+        status: 'valid',
+        value: parsed,
+        spoofedCount
+    } : {
+        status: 'invalid',
+        spoofedCount
+    };
+}
 const work_docx_paragraph_shading_import_WORD_NAMESPACE = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
 const work_docx_paragraph_shading_import_XML_NAMESPACE = 'http://www.w3.org/XML/1998/namespace';
 const work_docx_paragraph_shading_import_XMLNS_NAMESPACE = 'http://www.w3.org/2000/xmlns/';
@@ -6892,7 +6943,8 @@ const SUPPORTED_RUN_PROPERTY_CHANGE_CHILDREN = new Set([
     'cs',
     'rtl',
     'em',
-    'vertAlign'
+    'vertAlign',
+    'bdr'
 ]);
 function createImportedDocxRunFormattingMarkerState(documents) {
     return {
@@ -6997,6 +7049,7 @@ function resolvedRunFormatting(propertySources, theme, runText, requestedFontSlo
     const emphasisMark = resolveDocxEmphasisMark(propertySources);
     const hiddenText = resolveDocxHiddenText(propertySources);
     const legacyTextEffects = resolveDocxLegacyTextEffects(propertySources);
+    const runBorder = resolveDocxRunBorder(propertySources, theme).border;
     for (const properties of propertySources){
         bold = overriddenBoolean(bold, onOffProperty(properties, 'b'));
         complexBold = overriddenBoolean(complexBold, onOffProperty(properties, 'bCs'));
@@ -7154,6 +7207,9 @@ function resolvedRunFormatting(propertySources, theme, runText, requestedFontSlo
         } : {},
         ...textCase ? {
             textCase
+        } : {},
+        ...runBorder ? {
+            runBorder
         } : {}
     };
 }
@@ -7190,6 +7246,8 @@ function formattingMarkup(document, formatting) {
     if (void 0 !== formatting.emphasisMark) for (const [name, value] of Object.entries(documentEmphasisMarkDomAttributes(formatting.emphasisMark)))if ('style' === name) span.style.cssText += `; ${value}`;
     else span.setAttribute(name, value);
     if (void 0 !== formatting.hiddenText) for (const [name, value] of Object.entries(documentHiddenTextDomAttributes(formatting.hiddenText)))span.setAttribute(name, value);
+    if (formatting.runBorder) for (const [name, value] of Object.entries(documentRunBorderDomAttributes(formatting.runBorder)))if ('style' === name) span.style.cssText += `; ${value}`;
+    else span.setAttribute(name, value);
     const legacyTextEffects = {
         ...void 0 !== formatting.legacyTextOutline ? {
             outline: formatting.legacyTextOutline
@@ -7295,7 +7353,8 @@ function importedRunFormattingChange(runProperties, paragraphProperties, styles,
             legacyTextOutline: beforeFormatting.legacyTextOutline,
             legacyTextShadow: beforeFormatting.legacyTextShadow,
             legacyTextEmboss: beforeFormatting.legacyTextEmboss,
-            legacyTextImprint: beforeFormatting.legacyTextImprint
+            legacyTextImprint: beforeFormatting.legacyTextImprint,
+            runBorder: serializeDocumentRunBorder(beforeFormatting.runBorder)
         })
     };
 }
@@ -7458,4 +7517,4 @@ function work_docx_run_formatting_import_formatNumber(value) {
 function formatLineHeightFactor(value) {
     return Number(value.toFixed(4)).toString();
 }
-export { applyImportedDocxEquationMarkers, applyImportedDocxParagraphAlignmentMarkers, applyImportedDocxParagraphBorderMarkers, applyImportedDocxParagraphDirectionMarkers, applyImportedDocxParagraphFormattingChangeMarkers, applyImportedDocxParagraphIndentMarkers, applyImportedDocxParagraphPaginationMarkers, applyImportedDocxParagraphShadingMarkers, applyImportedDocxParagraphSpacingMarkers, applyImportedDocxParagraphTabStopMarkers, applyImportedDocxRunFormattingMarkers, createDocxParagraphStyleResolver, createDocxTableStyleResolver, createImportedDocxRunFormattingMarkerState, docxCaptionBookmark, docxCaptionReferenceTarget, docxCaptionSequenceKind, docxEquationHtml, docxFieldInstructions, docxFieldOccurrenceIsInlineEditable, docxFieldOccurrences, docxFieldResultText, docxRunPropertySources, docxTableCellStyleLayers, docxTablePropertySources, docxTableRunPropertySources, hasImportedDocxParagraphAlignmentMarkers, hasImportedDocxParagraphBorderMarkers, hasImportedDocxParagraphDirectionMarkers, hasImportedDocxParagraphFormattingChangeMarkers, hasImportedDocxParagraphIndentMarkers, hasImportedDocxParagraphPaginationMarkers, hasImportedDocxParagraphShadingMarkers, hasImportedDocxParagraphSpacingMarkers, hasImportedDocxParagraphTabStopMarkers, hasImportedDocxRunFormattingMarkers, hasInvalidDocxFieldStructure, importedDocxStrike, importedDocxUnderline, inspectDocxEquation, inspectDocxHiddenText, inspectDocxLegacyTextEffects, inspectDocxPageBorders, inspectDocxPageMarginSettings, inspectDocxPageMargins, inspectDocxPageSize, inspectDocxPaperSource, inspectDocxRunFonts, isDocxEquationLikeRoot, isSupportedDocxEquationPlacement, isSupportedDocxParagraphFormattingChange, isSupportedDocxRunFormattingChange, markDocxPackageEquations, markDocxParagraphAlignments, markDocxParagraphBorders, markDocxParagraphDirections, markDocxParagraphFormattingChanges, markDocxParagraphIndents, markDocxParagraphPagination, markDocxParagraphShading, markDocxParagraphSpacing, markDocxParagraphTabStops, markDocxRunFormattingIntoState, parseDirectDocxParagraphShading, parseDocxPageBorders, parseDocxPageGeometry, parseDocxPageMargins, parseDocxPaperSource, resolveDocxHiddenText, resolveDocxLegacyTextEffects, resolveDocxParagraphBordersForParagraph, resolveDocxTableStyleResolver };
+export { applyImportedDocxEquationMarkers, applyImportedDocxParagraphAlignmentMarkers, applyImportedDocxParagraphBorderMarkers, applyImportedDocxParagraphDirectionMarkers, applyImportedDocxParagraphFormattingChangeMarkers, applyImportedDocxParagraphIndentMarkers, applyImportedDocxParagraphPaginationMarkers, applyImportedDocxParagraphShadingMarkers, applyImportedDocxParagraphSpacingMarkers, applyImportedDocxParagraphTabStopMarkers, applyImportedDocxRunFormattingMarkers, createDocxParagraphStyleResolver, createDocxTableStyleResolver, createImportedDocxRunFormattingMarkerState, docxCaptionBookmark, docxCaptionReferenceTarget, docxCaptionSequenceKind, docxEquationHtml, docxFieldInstructions, docxFieldOccurrenceIsInlineEditable, docxFieldOccurrences, docxFieldResultText, docxRunPropertySources, docxTableCellStyleLayers, docxTablePropertySources, docxTableRunPropertySources, hasImportedDocxParagraphAlignmentMarkers, hasImportedDocxParagraphBorderMarkers, hasImportedDocxParagraphDirectionMarkers, hasImportedDocxParagraphFormattingChangeMarkers, hasImportedDocxParagraphIndentMarkers, hasImportedDocxParagraphPaginationMarkers, hasImportedDocxParagraphShadingMarkers, hasImportedDocxParagraphSpacingMarkers, hasImportedDocxParagraphTabStopMarkers, hasImportedDocxRunFormattingMarkers, hasInvalidDocxFieldStructure, importedDocxStrike, importedDocxUnderline, inspectDocxEquation, inspectDocxHiddenText, inspectDocxLegacyTextEffects, inspectDocxPageBorders, inspectDocxPageMarginSettings, inspectDocxPageMargins, inspectDocxPageSize, inspectDocxPaperSource, inspectDocxRunBorder, inspectDocxRunFonts, isDocxEquationLikeRoot, isSupportedDocxEquationPlacement, isSupportedDocxParagraphFormattingChange, isSupportedDocxRunFormattingChange, markDocxPackageEquations, markDocxParagraphAlignments, markDocxParagraphBorders, markDocxParagraphDirections, markDocxParagraphFormattingChanges, markDocxParagraphIndents, markDocxParagraphPagination, markDocxParagraphShading, markDocxParagraphSpacing, markDocxParagraphTabStops, markDocxRunFormattingIntoState, parseDirectDocxParagraphShading, parseDocxPageBorders, parseDocxPageGeometry, parseDocxPageMargins, parseDocxPaperSource, resolveDocxHiddenText, resolveDocxLegacyTextEffects, resolveDocxParagraphBordersForParagraph, resolveDocxRunBorder, resolveDocxTableStyleResolver };