@a3s-lab/office 0.27.0 → 0.28.0

package/dist/0~work-docx-export.js

@@ -1,5 +1,5 @@
 import jszip from "jszip";
-import { normalizeDocumentBookmarkName, normalizeDocumentEmphasisMark, DOCUMENT_STRIKE_STYLE_ATTRIBUTE, applyDocumentImageIdentityToElement, documentEmphasisMarkFromElement, DOCUMENT_PAGE_BORDER_EDGES, DOCUMENT_UNDERLINE_STYLE_ATTRIBUTE, documentScriptFontSlotFromElement, normalizeDocumentColumns, createDocumentImageIdentityRegistry, serializeDocumentScriptFonts, documentCharacterSpacingTwipsFromElement, uniqueDocumentParagraphIdentity, documentCharacterPositionHalfPointsFromElement, normalizeDocumentTableVerticalAlign, documentTableColumnPercentagesFromElement, normalizeDocumentTextCase, documentTableCellMarginOverridesFromElement, applyDocumentTableRowIdentityToElement, normalizeDocumentBookmarksHtml, documentImageIdentityFromElement, documentTableGeometryFromElement, normalizeDocumentTableRowHeightRule, normalizeDocumentScriptFonts, documentNoteKey, normalizeDocumentHiddenText, normalizeDocumentParagraphBorders, normalizeDocumentTableBorderWidth, normalizeDocumentCharacterSpacingTwips, normalizeDocumentParagraphId, documentStrikeFormattingFromElement, normalizeDocumentTableBorderStyle, normalizeDocumentBookmarkReferencesHtml, documentCitationInstruction, parseDocumentParagraphBordersElement, documentImageWrapContourFromElement, documentImagePositionFromElement, normalizeDocumentCharacterScalePercent, documentScriptFontsFromElement, normalizeDocumentUnderlineStyle, documentPageMarginsForLayout, normalizeDocumentPageChrome, normalizeDocumentImageLayer, documentFontNameFromCssFamily, documentKerningThresholdHalfPointsFromElement, documentImageCropFromElement, documentBookmarkReferenceInstruction, normalizeDocumentPageBorders, documentImageLayerFromElement, parseDocumentScriptFonts, documentCaptionLabel, documentCaptionKind, applyDocumentParagraphIdentityToElement, isContourImageLayout, parseDocxThemeReference, normalizeDocumentImageIdentity, normalizeDocumentStrikeStyle, normalizeTableColor, createDocumentParagraphIdentityRegistry, documentCitationTags, docxDocumentFieldKind, documentTableBordersFromElement, documentSections, wrapsBesideImage, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentKerningThresholdHalfPoints, DocxThemePatchCollector, defaultDocumentImageWrapContour, normalizeDocumentParagraphIdentity, normalizeDocumentPaperSource, documentEquationFromElement, DOCUMENT_PARAGRAPH_BORDER_EDGES, parseDocumentCharacterFormatting, documentScriptFontFamily, documentUnderlineFormattingFromElement, documentParagraphIdentityFromElement, normalizeDocumentEquation, patchDocxThemeReferences, parseDocumentParagraphShadingElement, normalizeDocumentBookmarkNativeId, parseDocumentParagraphFormatting, DOCUMENT_PAGE_MARGIN_KEYS, uniqueDocumentImageIdentity, documentHiddenTextFromElement, documentTableRowIdentityFromElement, documentImageLayoutFromElement, documentScriptFontSlotFromHint, collectDocumentNotes, documentPageHorizontalMarginTwips, documentPageGeometryForLayout, normalizeDocumentScriptFontSlot, normalizeDocumentPageMargins, documentCharacterScalePercentFromElement, documentNoteKind } from "./6282.js";
+import { normalizeDocumentBookmarkName, normalizeDocumentEmphasisMark, DOCUMENT_STRIKE_STYLE_ATTRIBUTE, applyDocumentImageIdentityToElement, documentEmphasisMarkFromElement, DOCUMENT_PAGE_BORDER_EDGES, DOCUMENT_UNDERLINE_STYLE_ATTRIBUTE, documentScriptFontSlotFromElement, normalizeDocumentColumns, createDocumentImageIdentityRegistry, serializeDocumentScriptFonts, documentCharacterSpacingTwipsFromElement, uniqueDocumentParagraphIdentity, documentCharacterPositionHalfPointsFromElement, normalizeDocumentTableVerticalAlign, documentTableColumnPercentagesFromElement, normalizeDocumentTextCase, documentTableCellMarginOverridesFromElement, applyDocumentTableRowIdentityToElement, normalizeDocumentBookmarksHtml, documentImageIdentityFromElement, documentTableGeometryFromElement, normalizeDocumentTableRowHeightRule, normalizeDocumentScriptFonts, documentNoteKey, DOCUMENT_LEGACY_TEXT_EMBOSS_ATTRIBUTE, normalizeDocumentHiddenText, normalizeDocumentParagraphBorders, documentLegacyTextEffectsConflict, normalizeDocumentTableBorderWidth, normalizeDocumentCharacterSpacingTwips, normalizeDocumentParagraphId, documentStrikeFormattingFromElement, normalizeDocumentTableBorderStyle, normalizeDocumentBookmarkReferencesHtml, documentCitationInstruction, parseDocumentParagraphBordersElement, documentImageWrapContourFromElement, documentImagePositionFromElement, normalizeDocumentCharacterScalePercent, documentScriptFontsFromElement, normalizeDocumentUnderlineStyle, documentPageMarginsForLayout, normalizeDocumentPageChrome, normalizeDocumentImageLayer, documentFontNameFromCssFamily, documentBookmarkReferenceInstruction, documentImageCropFromElement, documentKerningThresholdHalfPointsFromElement, normalizeDocumentPageBorders, documentImageLayerFromElement, normalizeDocumentLegacyTextEffects, documentCaptionLabel, documentCaptionKind, applyDocumentParagraphIdentityToElement, DOCUMENT_LEGACY_TEXT_IMPRINT_ATTRIBUTE, isContourImageLayout, parseDocumentScriptFonts, normalizeDocumentStrikeStyle, parseDocxThemeReference, createDocumentParagraphIdentityRegistry, documentCitationTags, docxDocumentFieldKind, normalizeDocumentImageIdentity, normalizeTableColor, documentTableBordersFromElement, wrapsBesideImage, normalizeDocumentCharacterPositionHalfPoints, normalizeDocumentKerningThresholdHalfPoints, DocxThemePatchCollector, defaultDocumentImageWrapContour, documentSections, normalizeDocumentParagraphIdentity, normalizeDocumentPaperSource, DOCUMENT_LEGACY_TEXT_OUTLINE_ATTRIBUTE, documentEquationFromElement, DOCUMENT_PARAGRAPH_BORDER_EDGES, documentLegacyTextEffectsFromElement, parseDocumentCharacterFormatting, documentScriptFontFamily, documentParagraphIdentityFromElement, DOCUMENT_LEGACY_TEXT_SHADOW_ATTRIBUTE, normalizeDocumentEquation, documentUnderlineFormattingFromElement, normalizeDocumentBookmarkNativeId, patchDocxThemeReferences, DOCUMENT_PAGE_MARGIN_KEYS, uniqueDocumentImageIdentity, documentHiddenTextFromElement, parseDocumentParagraphShadingElement, documentImageLayoutFromElement, documentScriptFontSlotFromHint, parseDocumentParagraphFormatting, documentPageHorizontalMarginTwips, documentTableRowIdentityFromElement, collectDocumentNotes, documentPageGeometryForLayout, normalizeDocumentScriptFontSlot, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, documentCharacterScalePercentFromElement, normalizeDocumentPageMargins, normalizeDocumentLegacyTextEffect, documentNoteKind } from "./6282.js";
 import { serializeUtf8Xml, directChildren, xmlNamespacePrefix, parseXml, decodeXmlBytes, descendants, resolvePartTarget, directChild, attribute as work_ooxml_package_attribute } from "./5184.js";
 import { assignDocxNoteIds, patchDocxPageColor, normalizeDocxCommentId, assignDocxCommentThreads } from "./0~4980.js";
 import { paragraphTabStops, mergeDocxIgnorableExtensionsAtPairs, patchDocxBibliography, docxKerningThresholdValue, docxCharacterPositionValue, docxCharacterScaleValue, docxEmphasisMarkRunOptions, XMLNS_NAMESPACE as work_docx_settings_xml_XMLNS_NAMESPACE, paragraphAlignment, paragraphSpacingOptions, xmlNamespaceUri, hasNonWhitespaceXmlText, patchDocxExplicitZeroCharacterSpacing, cloneXmlElement, cssColorToHex, DocxParagraphDefaultCollapsedPatchCollector, assertXmlRoot, xmlDeclaredPrefix, paragraphIndent, domDirection, DOCX_WORDPROCESSING_NAMESPACES, paragraphBidirectional, XML_NAMESPACE as work_docx_settings_xml_XML_NAMESPACE, patchDocxParagraphDefaultCollapsed, xmlAttributeNamespace, dataBoolean, mergeDocxIgnorableExtensions, patchDocxExplicitZeroKerningThresholds, parseDocxColorSchemeMappingElement, paragraphPaginationOptions, DOCX_COLOR_SCHEME_MAPPING_ATTRIBUTES, xmlAttributeLocalName, cssFontSize, paragraphDirectionOptions, cssFontFamily, docxCharacterSpacingValue } from "./0~7043.js";
@@ -757,8 +757,7 @@ function hasAncestor(element, localName) {
     }
     return false;
 }
-const HIDDEN_TEXT_PART_PATTERN = /^word\/(?:document|header\d*|footer\d*|footnotes|endnotes|comments)\.xml$/i;
-const WORD_RUN_PROPERTY_ORDER = [
+const DOCX_RUN_PROPERTY_ORDER = [
     'rStyle',
     'rFonts',
     'b',
@@ -799,11 +798,12 @@ const WORD_RUN_PROPERTY_ORDER = [
     'specVanish',
     'rPrChange'
 ];
-const WORD_RUN_PROPERTY_RANK = new Map(WORD_RUN_PROPERTY_ORDER.map((name, index)=>[
+const DOCX_RUN_PROPERTY_RANK = new Map(DOCX_RUN_PROPERTY_ORDER.map((name, index)=>[
         name,
         index
     ]));
-const VANISH_RANK = WORD_RUN_PROPERTY_RANK.get('vanish') ?? 0;
+const HIDDEN_TEXT_PART_PATTERN = /^word\/(?:document|header\d*|footer\d*|footnotes|endnotes|comments)\.xml$/i;
+const VANISH_RANK = DOCX_RUN_PROPERTY_RANK.get('vanish') ?? 0;
 class DocxHiddenTextPatchCollector {
     patches = [];
     nextMarker = 1;
@@ -838,6 +838,9 @@ class DocxHiddenTextPatchCollector {
         this.markersByValueAndStyle.set(key, marker);
         return marker;
     }
+    lookup(marker) {
+        return marker ? this.patchesByMarker.get(marker) : void 0;
+    }
     originalStyle(style) {
         let current = style;
         const seen = new Set();
@@ -897,7 +900,7 @@ function insertHiddenTextProperty(document, properties, value) {
     if (!value) vanish.setAttributeNS(namespace, `${prefix}:val`, '0');
     const next = directChildren(properties).find((child)=>{
         if (!DOCX_WORDPROCESSING_NAMESPACES.has(child.namespaceURI ?? '')) return true;
-        return (WORD_RUN_PROPERTY_RANK.get(child.localName) ?? 1 / 0) > VANISH_RANK;
+        return (DOCX_RUN_PROPERTY_RANK.get(child.localName) ?? 1 / 0) > VANISH_RANK;
     });
     properties.insertBefore(vanish, next ?? null);
 }
@@ -911,6 +914,128 @@ function setWordValue(element, value) {
     for (const attribute of Array.from(element.attributes))if ('val' === xmlAttributeLocalName(attribute) && DOCX_WORDPROCESSING_NAMESPACES.has(xmlAttributeNamespace(element, attribute) ?? '')) element.removeAttributeNode(attribute);
     element.setAttributeNS(namespace, `${prefix}:val`, value);
 }
+const LEGACY_TEXT_EFFECTS_PART_PATTERN = /^word\/(?:document|header\d*|footer\d*|footnotes|endnotes|comments)\.xml$/i;
+class DocxLegacyTextEffectsPatchCollector {
+    patches = [];
+    nextMarker = 1;
+    occupied;
+    patchesByMarker = new Map();
+    markersByEffectsAndStyle = new Map();
+    constructor(source){
+        this.occupied = source;
+    }
+    marker(value, inheritedStyle) {
+        const effects = normalizeDocumentLegacyTextEffects(value);
+        if (!effects || !Object.keys(effects).length) throw new Error('Document contains invalid legacy text effects.');
+        const style = this.originalStyle(inheritedStyle);
+        const key = JSON.stringify([
+            DOCUMENT_LEGACY_TEXT_EFFECT_NAMES.map((name)=>effects[name] ?? null),
+            style ?? null
+        ]);
+        const existing = this.markersByEffectsAndStyle.get(key);
+        if (existing) return existing;
+        let marker = '';
+        do {
+            marker = `A3SOfficeLegacyTextEffects${String(this.nextMarker).padStart(8, '0')}`;
+            this.nextMarker += 1;
+        }while (this.occupied.includes(marker) || this.patches.some((patch)=>patch.marker === marker))
+        const patch = {
+            marker,
+            effects,
+            ...style ? {
+                style
+            } : {}
+        };
+        this.patches.push(patch);
+        this.patchesByMarker.set(marker, patch);
+        this.markersByEffectsAndStyle.set(key, marker);
+        return marker;
+    }
+    lookup(marker) {
+        return marker ? this.patchesByMarker.get(marker) : void 0;
+    }
+    originalStyle(style) {
+        let current = style;
+        const seen = new Set();
+        while(current && !seen.has(current)){
+            seen.add(current);
+            const patch = this.patchesByMarker.get(current);
+            if (!patch) break;
+            current = patch.style;
+        }
+        return current;
+    }
+}
+async function patchDocxLegacyTextEffects(buffer, patches) {
+    if (!patches.length) return buffer;
+    const byMarker = new Map();
+    for (const patch of patches){
+        const effects = normalizeDocumentLegacyTextEffects(patch.effects);
+        if (!patch.marker || !effects || !Object.keys(effects).length || byMarker.has(patch.marker)) throw new Error('Document contains invalid legacy text-effect patches.');
+        byMarker.set(patch.marker, {
+            ...patch,
+            effects
+        });
+    }
+    const archive = await jszip.loadAsync(buffer);
+    const applied = new Set();
+    for (const entry of Object.values(archive.files)){
+        if (entry.dir || !LEGACY_TEXT_EFFECTS_PART_PATTERN.test(entry.name)) continue;
+        const document = parseXml(decodeXmlBytes(await entry.async('uint8array'), `generated DOCX ${entry.name}`), `generated DOCX ${entry.name}`);
+        let changed = false;
+        for (const properties of descendants(document, 'rPr')){
+            if (!DOCX_WORDPROCESSING_NAMESPACES.has(properties.namespaceURI ?? '')) continue;
+            const markerStyles = directChildren(properties, 'rStyle').filter((style)=>{
+                if (!DOCX_WORDPROCESSING_NAMESPACES.has(style.namespaceURI ?? '')) return false;
+                const marker = work_docx_legacy_text_effects_export_wordValue(style);
+                return null !== marker && byMarker.has(marker);
+            });
+            if (!markerStyles.length) continue;
+            if (1 !== markerStyles.length) throw new Error('Generated DOCX legacy text-effect marker is duplicated in one run.');
+            const marker = work_docx_legacy_text_effects_export_wordValue(markerStyles[0]);
+            const patch = marker ? byMarker.get(marker) : void 0;
+            if (marker && patch) {
+                if (DOCUMENT_LEGACY_TEXT_EFFECT_NAMES.some((name)=>directChildren(properties, name).length > 0)) throw new Error('Generated DOCX legacy text-effect marker unexpectedly has a native value.');
+                if (patch.style) work_docx_legacy_text_effects_export_setWordValue(markerStyles[0], patch.style);
+                else markerStyles[0].remove();
+                for (const name of DOCUMENT_LEGACY_TEXT_EFFECT_NAMES){
+                    const value = patch.effects[name];
+                    if (void 0 !== value) insertLegacyTextEffectProperty(document, properties, name, value);
+                }
+                applied.add(marker);
+                changed = true;
+            }
+        }
+        if (changed) archive.file(entry.name, serializeUtf8Xml(document));
+    }
+    const missing = patches.filter((patch)=>!applied.has(patch.marker));
+    if (missing.length) throw new Error(`DOCX legacy text-effect markers were not emitted: ${missing.map((patch)=>patch.marker).join(', ')}.`);
+    return archive.generateAsync({
+        type: 'arraybuffer'
+    });
+}
+function insertLegacyTextEffectProperty(document, properties, name, value) {
+    const namespace = properties.namespaceURI ?? '';
+    const prefix = properties.prefix || 'w';
+    const effect = document.createElementNS(namespace, `${prefix}:${name}`);
+    if (!value) effect.setAttributeNS(namespace, `${prefix}:val`, '0');
+    const rank = DOCX_RUN_PROPERTY_RANK.get(name) ?? 0;
+    const next = directChildren(properties).find((child)=>{
+        if (!DOCX_WORDPROCESSING_NAMESPACES.has(child.namespaceURI ?? '')) return true;
+        return (DOCX_RUN_PROPERTY_RANK.get(child.localName) ?? 1 / 0) > rank;
+    });
+    properties.insertBefore(effect, next ?? null);
+}
+function work_docx_legacy_text_effects_export_wordValue(element) {
+    const values = Array.from(element.attributes).filter((attribute)=>'val' === xmlAttributeLocalName(attribute) && DOCX_WORDPROCESSING_NAMESPACES.has(xmlAttributeNamespace(element, attribute) ?? ''));
+    return 1 === values.length ? values[0].value : null;
+}
+function work_docx_legacy_text_effects_export_setWordValue(element, value) {
+    const namespace = element.namespaceURI ?? '';
+    const prefix = element.prefix || 'w';
+    for (const attribute of Array.from(element.attributes))if ('val' === xmlAttributeLocalName(attribute) && DOCX_WORDPROCESSING_NAMESPACES.has(xmlAttributeNamespace(element, attribute) ?? '')) element.removeAttributeNode(attribute);
+    element.setAttributeNS(namespace, `${prefix}:val`, value);
+}
 const MATH_NAMESPACE = 'http://schemas.openxmlformats.org/officeDocument/2006/math';
 const work_docx_equation_export_WORD_NAMESPACE = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
 const WORD_DATE_UTC_NAMESPACE = 'http://schemas.microsoft.com/office/word/2023/wordml/word16du';
@@ -2375,9 +2500,10 @@ function appendFormattingProperties(document, properties, namespace, prefix, ser
     appendBooleanProperty(document, properties, namespace, prefix, byType, 'bold', 'bCs');
     appendBooleanProperty(document, properties, namespace, prefix, byType, 'italic', 'i');
     appendBooleanProperty(document, properties, namespace, prefix, byType, 'italic', 'iCs');
-    appendUnderlineProperty(document, properties, namespace, prefix, byType.get('underline'));
-    appendStrikeProperties(document, properties, namespace, prefix, byType.get('strike'));
     appendTextCaseProperties(document, properties, namespace, prefix, byType.get('textStyle'));
+    appendStrikeProperties(document, properties, namespace, prefix, byType.get('strike'));
+    appendLegacyTextEffectsProperties(document, properties, namespace, prefix, byType.get('textStyle'));
+    appendSnapToGridProperty(document, properties, namespace, prefix, byType.get('textStyle'));
     appendHiddenTextProperty(document, properties, namespace, prefix, byType.get('textStyle'));
     appendColorProperty(document, properties, namespace, prefix, byType.get('textStyle'));
     appendCharacterSpacingProperty(document, properties, namespace, prefix, byType.get('textStyle'));
@@ -2386,10 +2512,41 @@ function appendFormattingProperties(document, properties, namespace, prefix, ser
     appendCharacterPositionProperty(document, properties, namespace, prefix, byType.get('textStyle'));
     appendFontSizeProperties(document, properties, namespace, prefix, byType.get('textStyle'));
     appendHighlightProperty(document, properties, namespace, prefix, byType.get('highlight'));
-    appendSnapToGridProperty(document, properties, namespace, prefix, byType.get('textStyle'));
+    appendUnderlineProperty(document, properties, namespace, prefix, byType.get('underline'));
     appendVerticalAlignProperty(document, properties, namespace, prefix, byType);
     appendEmphasisMarkProperty(document, properties, namespace, prefix, byType.get('textStyle'));
 }
+function appendLegacyTextEffectsProperties(document, properties, namespace, prefix, mark) {
+    const effects = {};
+    const attributes = [
+        [
+            'outline',
+            'legacyTextOutline'
+        ],
+        [
+            'shadow',
+            'legacyTextShadow'
+        ],
+        [
+            'emboss',
+            'legacyTextEmboss'
+        ],
+        [
+            'imprint',
+            'legacyTextImprint'
+        ]
+    ];
+    for (const [effect, attribute] of attributes){
+        const value = normalizeDocumentLegacyTextEffect(mark?.attrs?.[attribute]);
+        if (null !== value) effects[effect] = value;
+    }
+    if (documentLegacyTextEffectsConflict(effects)) throw new Error('Document contains conflicting legacy text effects.');
+    for (const name of DOCUMENT_LEGACY_TEXT_EFFECT_NAMES){
+        const value = effects[name];
+        if (void 0 !== value) if (value) properties.append(wordElement(document, namespace, prefix, name));
+        else appendValuedProperty(document, properties, namespace, prefix, name, '0');
+    }
+}
 function appendHiddenTextProperty(document, properties, namespace, prefix, mark) {
     const hiddenText = normalizeDocumentHiddenText(mark?.attrs?.hiddenText);
     if (null === hiddenText) return;
@@ -7707,6 +7864,8 @@ async function createDocxBlob(content, sourcePackage) {
         formattingChangePatches: new DocxRunFormattingChangePatchCollector(),
         runFontPatches: new DocxRunFontsPatchCollector(JSON.stringify(normalizedContent)),
         hiddenTextPatches: new DocxHiddenTextPatchCollector(JSON.stringify(normalizedContent)),
+        legacyTextEffectsPatches: new DocxLegacyTextEffectsPatchCollector(JSON.stringify(normalizedContent)),
+        usedNativeTextEffectMarkers: new Set(),
         paragraphFormattingChangePatches: new DocxParagraphFormattingChangePatchCollector(),
         hasExplicitZeroCharacterSpacing: false,
         hasExplicitZeroKerningThreshold: false
@@ -7759,8 +7918,9 @@ async function createDocxBlob(content, sourcePackage) {
     const characterSpacingPatched = noteContext.hasExplicitZeroCharacterSpacing ? await patchDocxExplicitZeroCharacterSpacing(await packed.arrayBuffer()) : await packed.arrayBuffer();
     const kerningPatched = noteContext.hasExplicitZeroKerningThreshold ? await patchDocxExplicitZeroKerningThresholds(characterSpacingPatched) : characterSpacingPatched;
     const runFontsPatched = await patchDocxRunFonts(kerningPatched, noteContext.runFontPatches.patches);
-    const hiddenTextPatched = await patchDocxHiddenText(runFontsPatched, noteContext.hiddenTextPatches.patches);
-    const formattingChangesPatched = await patchDocxRunFormattingChanges(hiddenTextPatched, noteContext.formattingChangePatches.patches);
+    const hiddenTextPatched = await patchDocxHiddenText(runFontsPatched, noteContext.hiddenTextPatches.patches.filter((patch)=>noteContext.usedNativeTextEffectMarkers.has(patch.marker)));
+    const legacyTextEffectsPatched = await patchDocxLegacyTextEffects(hiddenTextPatched, noteContext.legacyTextEffectsPatches.patches.filter((patch)=>noteContext.usedNativeTextEffectMarkers.has(patch.marker)));
+    const formattingChangesPatched = await patchDocxRunFormattingChanges(legacyTextEffectsPatched, noteContext.formattingChangePatches.patches);
     const noteImageRelationshipsPatched = await patchDocxNoteImageRelationships(formattingChangesPatched);
     const commentMetadataPatched = await patchDocxCommentMetadata(noteImageRelationshipsPatched, commentThreads);
     const numberingPatched = await patchDocxNumberingRestartRules(commentMetadataPatched, noteContext.numberingRestartRules);
@@ -7787,6 +7947,60 @@ async function createDocxBlob(content, sourcePackage) {
         type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
     });
 }
+function docxNativeTextEffectState(style, context) {
+    let current = style;
+    let hiddenText;
+    const legacyTextEffects = {};
+    const seen = new Set();
+    while(current && !seen.has(current)){
+        seen.add(current);
+        const hiddenPatch = context.hiddenTextPatches.lookup(current);
+        if (hiddenPatch) {
+            hiddenText ??= hiddenPatch.value;
+            current = hiddenPatch.style;
+            continue;
+        }
+        const legacyPatch = context.legacyTextEffectsPatches.lookup(current);
+        if (legacyPatch) {
+            for (const [name, value] of Object.entries(legacyPatch.effects)){
+                const effect = name;
+                if (void 0 === legacyTextEffects[effect]) legacyTextEffects[effect] = value;
+            }
+            current = legacyPatch.style;
+            continue;
+        }
+        break;
+    }
+    return {
+        ...current ? {
+            baseStyle: current
+        } : {},
+        ...void 0 !== hiddenText ? {
+            hiddenText
+        } : {},
+        legacyTextEffects
+    };
+}
+function markDocxNativeTextEffectStyleUsed(style, context) {
+    let current = style;
+    const seen = new Set();
+    while(current && !seen.has(current)){
+        seen.add(current);
+        const hiddenPatch = context.hiddenTextPatches.lookup(current);
+        if (hiddenPatch) {
+            context.usedNativeTextEffectMarkers.add(current);
+            current = hiddenPatch.style;
+            continue;
+        }
+        const legacyPatch = context.legacyTextEffectsPatches.lookup(current);
+        if (legacyPatch) {
+            context.usedNativeTextEffectMarkers.add(current);
+            current = legacyPatch.style;
+            continue;
+        }
+        break;
+    }
+}
 function work_docx_export_sectionProperties(layout, docx) {
     const landscape = 'landscape' === layout.orientation;
     const dimensions = documentPageGeometryForLayout(layout);
@@ -7956,6 +8170,7 @@ async function work_docx_export_inlineRuns(root, docx, noteContext) {
     const visit = async (node, inherited = {}, revision)=>{
         if (node.nodeType === Node.TEXT_NODE) {
             if (!node.textContent) return [];
+            markDocxNativeTextEffectStyleUsed(inherited.style, noteContext);
             if (revision?.kind === 'insertion') return [
                 new docx.InsertedTextRun({
                     ...inherited,
@@ -8026,6 +8241,14 @@ async function work_docx_export_inlineRuns(root, docx, noteContext) {
         const explicitKerningThreshold = documentKerningThresholdHalfPointsFromElement(node);
         const explicitEmphasisMark = documentEmphasisMarkFromElement(node);
         const explicitHiddenText = documentHiddenTextFromElement(node);
+        const hasExplicitLegacyTextEffects = 'span' === tag && [
+            DOCUMENT_LEGACY_TEXT_OUTLINE_ATTRIBUTE,
+            DOCUMENT_LEGACY_TEXT_SHADOW_ATTRIBUTE,
+            DOCUMENT_LEGACY_TEXT_EMBOSS_ATTRIBUTE,
+            DOCUMENT_LEGACY_TEXT_IMPRINT_ATTRIBUTE
+        ].some((attribute)=>node.hasAttribute(attribute));
+        const explicitLegacyTextEffects = hasExplicitLegacyTextEffects ? documentLegacyTextEffectsFromElement(node) : {};
+        if (hasExplicitLegacyTextEffects && !explicitLegacyTextEffects) throw new Error('Document contains invalid legacy text effects.');
         const explicitCharacterPosition = documentCharacterPositionHalfPointsFromElement(node);
         if (0 === explicitCharacterSpacing) noteContext.hasExplicitZeroCharacterSpacing = true;
         if (0 === explicitKerningThreshold) noteContext.hasExplicitZeroKerningThreshold = true;
@@ -8035,13 +8258,25 @@ async function work_docx_export_inlineRuns(root, docx, noteContext) {
         const position = null === explicitCharacterPosition ? inherited.position : docxCharacterPositionValue(explicitCharacterPosition);
         const emphasisMark = null === explicitEmphasisMark ? inherited.emphasisMark : docxEmphasisMarkRunOptions(explicitEmphasisMark);
         const textCaseOptions = docxTextCaseRunOptions(explicitTextCase, inherited);
-        const hiddenTextStyle = null === explicitHiddenText ? inherited.style : noteContext.hiddenTextPatches.marker(explicitHiddenText, inherited.style);
+        const inheritedNativeTextEffects = docxNativeTextEffectState(inherited.style, noteContext);
+        const legacyTextEffects = {
+            ...inheritedNativeTextEffects.legacyTextEffects,
+            ...explicitLegacyTextEffects ?? {}
+        };
+        if (documentLegacyTextEffectsConflict(legacyTextEffects)) throw new Error('Document contains conflicting legacy text effects.');
+        const hiddenText = null === explicitHiddenText ? inheritedNativeTextEffects.hiddenText : explicitHiddenText;
+        let nativeTextEffectStyle = inherited.style;
+        if (hasExplicitLegacyTextEffects || null !== explicitHiddenText) {
+            nativeTextEffectStyle = inheritedNativeTextEffects.baseStyle;
+            if (Object.keys(legacyTextEffects).length) nativeTextEffectStyle = noteContext.legacyTextEffectsPatches.marker(legacyTextEffects, nativeTextEffectStyle);
+            if (void 0 !== hiddenText) nativeTextEffectStyle = noteContext.hiddenTextPatches.marker(hiddenText, nativeTextEffectStyle);
+        }
         const underline = docxUnderlineRunOptions(node, inherited.underline, noteContext.themePatches);
         const strike = docxStrikeRunOptions(node, inherited);
         const scriptFontMarker = noteContext.runFontPatches.marker(documentScriptFontsFromElement(node), documentScriptFontSlotFromElement(node), node.style.fontFamily);
         const style = {
             ...inherited,
-            style: hiddenTextStyle,
+            style: nativeTextEffectStyle,
             bold: inherited.bold || 'strong' === tag || 'b' === tag,
             italics: inherited.italics || 'em' === tag || 'i' === tag,
             underline,
@@ -8065,12 +8300,15 @@ async function work_docx_export_inlineRuns(root, docx, noteContext) {
             rightToLeft: void 0 === direction ? inherited.rightToLeft : 'rtl' === direction,
             ...textCaseOptions
         };
-        if ('br' === tag) return [
-            new docx.TextRun({
-                ...style,
-                break: 1
-            })
-        ];
+        if ('br' === tag) {
+            markDocxNativeTextEffectStyleUsed(style.style, noteContext);
+            return [
+                new docx.TextRun({
+                    ...style,
+                    break: 1
+                })
+            ];
+        }
         if ('img' === tag) return [
             await imageToDocx(node, docx, noteContext.imageCropPatches, noteContext.imageWrapPatches, noteContext.imageLayerPatches, noteContext.imageIdentityPatches)
         ];

package/dist/0~work-docx-import.js

@@ -1,7 +1,7 @@
 import jszip from "jszip";
 import { contentTypeForPart, directChildren, bytesToDataUrl, OoxmlPackage, firstDescendant, descendants, directChild, attribute as work_ooxml_package_attribute } from "./5184.js";
-import { normalizeDocumentBookmarkName, renderDocumentTableCellMarginOverrides, applyDocumentImageIdentityToElement, documentCharacterPositionDomAttributes, createDocumentImageIdentityRegistry, normalizeDocumentColumns, documentStrikeDomAttributes, normalizeDocumentImageWrapContour, DOCUMENT_TABLE_ROW_ID_ATTRIBUTE, normalizeDocumentBookmarksHtml, applyDocumentTableRowIdentityToElement, normalizeDocumentCaptionsHtml, documentCharacterSpacingDomAttributes, normalizeDocumentImageAlignment, normalizeDocumentParagraphId, applyDocumentImageLayerToElement, normalizeDocumentNotesHtml, normalizeDocumentBookmarkReferencesHtml, documentCitationTagsFromInstruction, applyDocumentImageWrapContourToElement, documentUnderlineDomAttributes, documentHiddenTextDomAttributes, normalizeDocumentPageChrome, normalizeDocumentImageLayoutOptions, applyDocumentImageCropToElement, documentPageMarginsForLayout, applyDocumentPageGeometry, createDocumentNoteElement, normalizeDocumentImageLayer, DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE, documentBookmarkReferenceInstruction, documentInitialSectionLayout, normalizeDocumentFieldsHtml, documentCaptionLabel, documentTableBordersFromElement, isContourImageLayout, normalizeDocumentCitationsHtml, normalizeDocumentImageIdentity, normalizeDocumentImageWrapSide, applyDocumentParagraphIdentityToElement, documentKerningDomAttributes, docxDocumentFieldKind, serializeDocxThemeReference, renderDocumentTableBorders, docxBookmarkReferenceTarget, normalizeDocumentImagePosition, wrapsBesideImage, documentPageChromeLegacyFields, documentParagraphShadingDomAttributes, documentCharacterScaleDomAttributes, documentParagraphBordersDomAttributes, DEFAULT_DOCUMENT_TABLE_GEOMETRY, documentSectionDomAttributes, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, normalizeDocumentParagraphIdentity, documentPageMarginBody, normalizeDocumentTableRowIdentity, normalizeDocumentBookmarkNativeId, uniqueDocumentImageIdentity, applyDocumentTableGeometryToElement, normalizeDocumentImageCrop, documentContentLayoutProperties, documentEmphasisMarkDomAttributes } from "./6282.js";
-import { markDocxRunFormattingIntoState, applyImportedDocxParagraphSpacingMarkers, hasImportedDocxParagraphDirectionMarkers, hasImportedDocxParagraphIndentMarkers, resolveDocxParagraphBordersForParagraph, applyImportedDocxParagraphShadingMarkers, markDocxParagraphSpacing, docxCaptionBookmark, docxFieldResultText, createDocxParagraphStyleResolver, docxTableCellStyleLayers, createImportedDocxRunFormattingMarkerState, parseDocxPaperSource, hasImportedDocxParagraphSpacingMarkers, docxTablePropertySources, parseDocxPageMargins, parseDirectDocxParagraphShading, markDocxPackageEquations, parseDocxPageGeometry, markDocxParagraphIndents, docxCaptionReferenceTarget, applyImportedDocxEquationMarkers, hasImportedDocxParagraphPaginationMarkers, createDocxTableStyleResolver, hasImportedDocxParagraphShadingMarkers, isDocxEquationLikeRoot, importedDocxStrike, docxTableRunPropertySources, inspectDocxPageMarginSettings, hasImportedDocxRunFormattingMarkers, applyImportedDocxParagraphFormattingChangeMarkers, hasImportedDocxParagraphTabStopMarkers, docxCaptionSequenceKind, applyImportedDocxRunFormattingMarkers, markDocxParagraphAlignments, markDocxParagraphDirections, hasImportedDocxParagraphBorderMarkers, hasImportedDocxParagraphFormattingChangeMarkers, resolveDocxHiddenText, docxEquationHtml, docxFieldOccurrences, hasImportedDocxParagraphAlignmentMarkers, markDocxParagraphTabStops, applyImportedDocxParagraphIndentMarkers, resolveDocxTableStyleResolver, applyImportedDocxParagraphDirectionMarkers, applyImportedDocxParagraphAlignmentMarkers, markDocxParagraphPagination, importedDocxUnderline, markDocxParagraphBorders, applyImportedDocxParagraphTabStopMarkers, docxFieldOccurrenceIsInlineEditable, applyImportedDocxParagraphBorderMarkers, applyImportedDocxParagraphPaginationMarkers, docxRunPropertySources, markDocxParagraphFormattingChanges, markDocxParagraphShading, parseDocxPageBorders } from "./0~5093.js";
+import { normalizeDocumentBookmarkName, renderDocumentTableCellMarginOverrides, applyDocumentImageIdentityToElement, documentCharacterPositionDomAttributes, createDocumentImageIdentityRegistry, normalizeDocumentColumns, documentStrikeDomAttributes, normalizeDocumentImageWrapContour, DOCUMENT_TABLE_ROW_ID_ATTRIBUTE, normalizeDocumentBookmarksHtml, applyDocumentTableRowIdentityToElement, normalizeDocumentCaptionsHtml, documentCharacterSpacingDomAttributes, normalizeDocumentImageAlignment, normalizeDocumentParagraphId, applyDocumentImageLayerToElement, normalizeDocumentNotesHtml, normalizeDocumentBookmarkReferencesHtml, documentCitationTagsFromInstruction, applyDocumentImageWrapContourToElement, documentUnderlineDomAttributes, documentHiddenTextDomAttributes, normalizeDocumentPageChrome, normalizeDocumentImageLayoutOptions, applyDocumentImageCropToElement, documentPageMarginsForLayout, applyDocumentPageGeometry, createDocumentNoteElement, normalizeDocumentImageLayer, DOCUMENT_TABLE_ROW_TEXT_ID_ATTRIBUTE, documentBookmarkReferenceInstruction, documentInitialSectionLayout, normalizeDocumentFieldsHtml, documentCaptionLabel, documentTableBordersFromElement, isContourImageLayout, normalizeDocumentCitationsHtml, normalizeDocumentImageIdentity, normalizeDocumentImageWrapSide, applyDocumentParagraphIdentityToElement, documentKerningDomAttributes, docxDocumentFieldKind, serializeDocxThemeReference, renderDocumentTableBorders, docxBookmarkReferenceTarget, normalizeDocumentImagePosition, wrapsBesideImage, documentPageChromeLegacyFields, documentParagraphShadingDomAttributes, documentCharacterScaleDomAttributes, documentParagraphBordersDomAttributes, DEFAULT_DOCUMENT_TABLE_GEOMETRY, documentSectionDomAttributes, DEFAULT_DOCUMENT_TABLE_CELL_MARGINS, normalizeDocumentParagraphIdentity, documentPageMarginBody, documentLegacyTextEffectsDomAttributes, normalizeDocumentTableRowIdentity, normalizeDocumentBookmarkNativeId, uniqueDocumentImageIdentity, applyDocumentTableGeometryToElement, normalizeDocumentImageCrop, documentContentLayoutProperties, documentEmphasisMarkDomAttributes } from "./6282.js";
+import { markDocxRunFormattingIntoState, applyImportedDocxParagraphSpacingMarkers, hasImportedDocxParagraphDirectionMarkers, hasImportedDocxParagraphIndentMarkers, resolveDocxParagraphBordersForParagraph, applyImportedDocxParagraphShadingMarkers, markDocxParagraphSpacing, docxCaptionBookmark, docxFieldResultText, createDocxParagraphStyleResolver, docxTableCellStyleLayers, createImportedDocxRunFormattingMarkerState, parseDocxPaperSource, resolveDocxLegacyTextEffects, hasImportedDocxParagraphSpacingMarkers, docxTablePropertySources, parseDocxPageMargins, parseDirectDocxParagraphShading, markDocxPackageEquations, parseDocxPageGeometry, markDocxParagraphIndents, docxCaptionReferenceTarget, applyImportedDocxEquationMarkers, hasImportedDocxParagraphPaginationMarkers, createDocxTableStyleResolver, hasImportedDocxParagraphShadingMarkers, isDocxEquationLikeRoot, importedDocxStrike, docxTableRunPropertySources, inspectDocxPageMarginSettings, hasImportedDocxRunFormattingMarkers, applyImportedDocxParagraphFormattingChangeMarkers, hasImportedDocxParagraphTabStopMarkers, docxCaptionSequenceKind, applyImportedDocxRunFormattingMarkers, markDocxParagraphAlignments, markDocxParagraphDirections, hasImportedDocxParagraphBorderMarkers, hasImportedDocxParagraphFormattingChangeMarkers, resolveDocxHiddenText, docxEquationHtml, docxFieldOccurrences, hasImportedDocxParagraphAlignmentMarkers, markDocxParagraphTabStops, applyImportedDocxParagraphIndentMarkers, resolveDocxTableStyleResolver, applyImportedDocxParagraphTabStopMarkers, applyImportedDocxParagraphDirectionMarkers, applyImportedDocxParagraphAlignmentMarkers, importedDocxUnderline, markDocxParagraphBorders, markDocxParagraphPagination, docxFieldOccurrenceIsInlineEditable, applyImportedDocxParagraphBorderMarkers, applyImportedDocxParagraphPaginationMarkers, docxRunPropertySources, markDocxParagraphFormattingChanges, markDocxParagraphShading, parseDocxPageBorders } from "./0~5093.js";
 import { readDocxBibliography, XMLNS_NAMESPACE, docxCharacterScalePercentFromProperties, docxCharacterSpacingTwipsFromProperties, parseBoundedDocxInteger, xmlAttributeLocalName, resolveDocxEmphasisMark, createDocxThemeResolver, docxCharacterPositionHalfPointsFromProperties, docxThemeColor, parseDocxParagraphDefaultCollapsed, resolveDocxKerningThresholdHalfPoints, resolveDocxThemeResolver, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace } from "./0~7043.js";
 import { importDocxPageColor, importedDocumentNoteId } from "./0~4980.js";
 const WORD_NAMESPACE = 'http://schemas.openxmlformats.org/wordprocessingml/2006/main';
@@ -1824,6 +1824,8 @@ async function runHtml(run, field, context) {
     if (void 0 !== emphasisMark) content = `<span${htmlAttributes(documentEmphasisMarkDomAttributes(emphasisMark))}>${content}</span>`;
     const hiddenText = resolveDocxHiddenText(propertySources);
     if (void 0 !== hiddenText) content = `<span${htmlAttributes(documentHiddenTextDomAttributes(hiddenText))}>${content}</span>`;
+    const legacyTextEffects = resolveDocxLegacyTextEffects(propertySources);
+    if (legacyTextEffects) content = `<span${htmlAttributes(documentLegacyTextEffectsDomAttributes(legacyTextEffects))}>${content}</span>`;
     const characterSpacing = docxCharacterSpacingTwipsFromProperties(properties ?? run);
     if (void 0 !== characterSpacing) content = `<span${htmlAttributes(documentCharacterSpacingDomAttributes(characterSpacing))}>${content}</span>`;
     const color = work_ooxml_package_attribute(directChild(properties ?? run, 'color') ?? run, 'val');

package/dist/0~work-office-diagnostics.js

@@ -1,7 +1,7 @@
 import { __webpack_require__ } from "./0~rslib-runtime.js";
 import { contentTypeForPart, directChildren, OoxmlPackage, parseXml, firstDescendant, descendants, directChild, xmlContainsAnyElement, attribute } from "./5184.js";
-import { normalizeDocumentBookmarkName, docxBookmarkReferenceTarget, normalizeDocumentBookmarkNativeId, isDocumentParagraphArtBorderStyle, supportedDocxBookmarkReferenceInstruction, documentCitationTagsFromInstruction, docxDocumentFieldKind } from "./6282.js";
-import { markDocxParagraphShading, inspectDocxPageSize, docxCaptionBookmark, hasInvalidDocxFieldStructure, inspectDocxPageMargins, inspectDocxPaperSource, createDocxParagraphStyleResolver, createDocxTableStyleResolver, inspectDocxRunFonts, docxFieldOccurrences, inspectDocxEquation, inspectDocxPageMarginSettings, markDocxParagraphBorders, isSupportedDocxParagraphFormattingChange, docxFieldOccurrenceIsInlineEditable, inspectDocxHiddenText, docxCaptionSequenceKind, inspectDocxPageBorders, isSupportedDocxRunFormattingChange, docxFieldInstructions, isSupportedDocxEquationPlacement } from "./0~5093.js";
+import { normalizeDocumentBookmarkName, docxBookmarkReferenceTarget, isDocumentParagraphArtBorderStyle, DOCUMENT_LEGACY_TEXT_EFFECT_NAMES, normalizeDocumentBookmarkNativeId, supportedDocxBookmarkReferenceInstruction, documentCitationTagsFromInstruction, docxDocumentFieldKind } from "./6282.js";
+import { markDocxParagraphShading, inspectDocxPageSize, docxCaptionBookmark, hasInvalidDocxFieldStructure, inspectDocxLegacyTextEffects, inspectDocxPageMargins, inspectDocxPaperSource, createDocxParagraphStyleResolver, createDocxTableStyleResolver, docxFieldOccurrences, inspectDocxRunFonts, inspectDocxEquation, inspectDocxPageMarginSettings, markDocxParagraphBorders, isSupportedDocxParagraphFormattingChange, docxFieldOccurrenceIsInlineEditable, inspectDocxHiddenText, docxCaptionSequenceKind, inspectDocxPageBorders, isSupportedDocxRunFormattingChange, docxFieldInstructions, isSupportedDocxEquationPlacement } from "./0~5093.js";
 import { normalizeDocumentHref } from "./0~work-document-links.js";
 import { xmlAttributeLocalName, readDocxBibliography, inspectDocxEmphasisMark, createDocxThemeResolver, parseDocxParagraphDefaultCollapsed, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, inspectDocxKerningThresholdHalfPoints } from "./0~7043.js";
 import { updateSpreadsheetWorksheetCompatibilitySummary, inspectXlsxPivotTables, isSupportedXlsxChartLegend, isSupportedXlsxChartPlotLayout, xlsxChartNodeUsesStackedGrouping, isSupportedXlsxChartSeriesFormatting, readXlsxFormulaFeaturesFromPackage, inspectXlsxHeaderFooterText, emptySpreadsheetWorksheetCompatibilitySummary, isSupportedXlsxWorksheetImageContentType, MAX_XLSX_WORKSHEET_IMAGE_BYTES, xlsxChartSeriesFormattingShapeProperties, diagnoseXlsxProtection, isEditableXlsxPaperSizeCode, isSupportedXlsxCombinationChartNodes } from "./4104.js";
@@ -400,6 +400,56 @@ async function diagnoseDocxKerning(archive, document) {
     });
     return issues;
 }
+const LEGACY_TEXT_EFFECTS_DIAGNOSTIC_PART_PATTERN = /^word\/(?:document|styles|header\d*|footer\d*|footnotes|endnotes|comments)\.xml$/i;
+async function diagnoseDocxLegacyTextEffects(archive, document) {
+    const parts = [
+        document
+    ];
+    for (const path of archive.paths('word/'))if ('word/document.xml' !== path.toLowerCase() && LEGACY_TEXT_EFFECTS_DIAGNOSTIC_PART_PATTERN.test(path)) parts.push(await archive.xml(path));
+    const enabled = {
+        outline: 0,
+        shadow: 0,
+        emboss: 0,
+        imprint: 0
+    };
+    let validCount = 0;
+    let explicitFalseCount = 0;
+    let invalidCount = 0;
+    for (const part of parts){
+        const propertySets = descendants(part, 'rPr').filter((element)=>DOCX_WORDPROCESSING_NAMESPACES.has(element.namespaceURI ?? ''));
+        for (const properties of propertySets){
+            if (!DOCUMENT_LEGACY_TEXT_EFFECT_NAMES.some((name)=>directChildren(properties, name).length > 0)) continue;
+            const inspection = inspectDocxLegacyTextEffects(properties);
+            if ('valid' === inspection.status) for (const name of DOCUMENT_LEGACY_TEXT_EFFECT_NAMES){
+                const value = inspection.value[name];
+                if (void 0 !== value) {
+                    validCount += 1;
+                    if (value) enabled[name] += 1;
+                    else explicitFalseCount += 1;
+                }
+            }
+            else if ('invalid' === inspection.status) invalidCount += 1;
+        }
+        for (const name of DOCUMENT_LEGACY_TEXT_EFFECT_NAMES)invalidCount += descendants(part, name).filter((element)=>{
+            const parent = element.parentElement;
+            return !parent || 'rPr' !== parent.localName || !DOCX_WORDPROCESSING_NAMESPACES.has(parent.namespaceURI ?? '');
+        }).length;
+    }
+    const issues = [];
+    if (validCount) issues.push({
+        code: 'docx.legacy-text-effects',
+        severity: 'info',
+        feature: 'Legacy text effects',
+        message: `${validCount} native legacy text-effect value(s), including ${explicitFalseCount} explicit false reset(s), ${enabled.outline} enabled outline value(s), ${enabled.shadow} enabled shadow value(s), ${enabled.emboss} enabled emboss value(s), and ${enabled.imprint} enabled imprint value(s), were detected across document defaults, styles, body, page chrome, notes, comments, and formatting revisions. Editable Writer stories preserve w:outline, w:shadow, w:emboss, and w:imprint through independently mixed Font-dialog controls, conflict-aware one-step Undo, Format Painter, bounded CSS paint projections, and exact DOCX export. Outline plus shadow remains valid; emboss and imprint stay mutually exclusive with the other enabled legacy effects. The browser and PDF projections are bounded visual approximations rather than a claim of desktop-engine pixel identity, and no non-standard shortcut is invented.`
+    });
+    if (invalidCount) issues.push({
+        code: 'docx.legacy-text-effects.invalid',
+        severity: 'warning',
+        feature: 'Legacy text effects',
+        message: `${invalidCount} malformed, duplicated, misplaced, namespace-spoofed, text-bearing, child-bearing, extra-attribute, unknown, or conflicting legacy text-effect property set(s) are ignored instead of enabling contradictory or untrusted paint effects.`
+    });
+    return issues;
+}
 const WORDPROCESSINGML_NAMESPACES = new Set([
     'http://schemas.openxmlformats.org/wordprocessingml/2006/main',
     'http://purl.oclc.org/ooxml/wordprocessingml/main'
@@ -1879,6 +1929,7 @@ async function analyzeDocxCompatibility(file, messages, sourcePackage) {
             issues.push(...await diagnoseDocxKerning(archive, document));
             issues.push(...await diagnoseDocxEmphasisMarks(archive, document));
             issues.push(...await diagnoseDocxHiddenText(archive, document));
+            issues.push(...await diagnoseDocxLegacyTextEffects(archive, document));
             issues.push(...await diagnoseDocxRunFonts(archive, document));
         }
         issues.push(...await diagnoseDocxPageChrome(archive));
@@ -1910,7 +1961,7 @@ async function analyzeDocxCompatibility(file, messages, sourcePackage) {
             const supportedRunFormattingRevisionCount = runFormattingRevisions.filter(isSupportedDocxRunFormattingChange).length;
             const supportedParagraphFormattingRevisionCount = paragraphFormattingRevisions.filter(isSupportedDocxParagraphFormattingChange).length;
             if (textRevisions.some((revision)=>descendants(revision, 't').length || descendants(revision, 'delText').length)) issues.push(work_office_diagnostics_issue('docx.revisions', 'Tracked changes', 'Body-text insertions and deletions preserve their author and date, remain reviewable in Work, and round-trip as native DOCX revisions.', 'info'));
-            if (supportedRunFormattingRevisionCount) issues.push(work_office_diagnostics_issue('docx.revisions.formatting', 'Character-formatting revisions', `${supportedRunFormattingRevisionCount} bounded character-formatting revision(s) preserve author, date, current formatting, and prior bold, italic, underline, strike, subscript, superscript, font, size, color, highlight, character scale, spacing, kerning threshold, emphasis mark, baseline position, and grid state. They remain reviewable in Work and round-trip as native w:rPrChange records.`, 'info'));
+            if (supportedRunFormattingRevisionCount) issues.push(work_office_diagnostics_issue('docx.revisions.formatting', 'Character-formatting revisions', `${supportedRunFormattingRevisionCount} bounded character-formatting revision(s) preserve author, date, current formatting, and prior bold, italic, underline, strike, text case, hidden text, outline, shadow, emboss, imprint, subscript, superscript, font, size, color, highlight, character scale, spacing, kerning threshold, emphasis mark, baseline position, and grid state. They remain reviewable in Work and round-trip as native w:rPrChange records.`, 'info'));
             if (supportedParagraphFormattingRevisionCount) issues.push(work_office_diagnostics_issue('docx.revisions.paragraph-formatting', 'Paragraph-formatting revisions', `${supportedParagraphFormattingRevisionCount} bounded paragraph-formatting revision(s) preserve author, date, current formatting, and prior alignment, direction, indentation, spacing, pagination, outline, tab-stop, border, shading, and collapsed state. They remain reviewable in Work and round-trip as native w:pPrChange records.`, 'info'));
             if (textRevisions.some((revision)=>!descendants(revision, 't').length && !descendants(revision, 'delText').length) || supportedRunFormattingRevisionCount !== runFormattingRevisions.length || supportedParagraphFormattingRevisionCount !== paragraphFormattingRevisions.length || [
                 'moveFrom',

package/dist/5184.js

@@ -14,6 +14,13 @@ const WORK_TEMPLATES = [
         description: '目标、范围、里程碑与风险',
         accent: '#536de2'
     },
+    {
+        id: 'text-effects',
+        kind: 'document',
+        name: '文字效果',
+        description: '空心、阴影、阳文与阴文',
+        accent: '#6b5bd2'
+    },
     {
         id: 'blank-markdown',
         kind: 'markdown',
@@ -72,6 +79,7 @@ function createWorkId(prefix) {
 function initialTitle(templateId, kind) {
     const titles = {
         'project-brief': '新项目方案',
+        'text-effects': '文字效果示例',
         'quarterly-plan': '季度执行计划',
         'strategy-deck': '业务策略汇报'
     };
@@ -87,6 +95,11 @@ function contentForTemplate(templateId) {
         pageSize: 'a4',
         html: "<h1>新项目方案</h1><p><strong>负责人：</strong>项目团队　　<strong>更新日期：</strong>今天</p><blockquote><p>用一句话说明这项工作的目标，以及完成后会带来什么变化。</p></blockquote><h2>背景与目标</h2><p>描述当前情况、核心问题和可衡量的成功标准。</p><h2>工作范围</h2><ul><li><p>需要完成的关键交付物</p></li><li><p>明确不在本期范围内的事项</p></li></ul><h2>里程碑</h2><ol><li><p>方案确认</p></li><li><p>执行与评审</p></li><li><p>交付与复盘</p></li></ol><h2>风险与决策</h2><p>记录尚未解决的问题、依赖和决策负责人。</p>"
     };
+    if ('text-effects' === templateId) return {
+        type: 'document',
+        pageSize: 'a4',
+        html: '<h1>原生文字效果</h1><p>选择下面任一示例并打开字体高级设置，可以组合空心与阴影，或在互斥的阳文和阴文之间切换。</p><h2>可组合效果</h2><p><span data-office-legacy-text-outline="true" data-office-legacy-text-shadow="true">空心 + 阴影</span></p><p><span data-office-legacy-text-outline="true">空心</span></p><p><span data-office-legacy-text-shadow="true">阴影</span></p><h2>互斥效果</h2><p><span data-office-legacy-text-emboss="true">阳文</span></p><p><span data-office-legacy-text-imprint="true">阴文</span></p>'
+    };
     if ('quarterly-plan' === templateId) return {
         type: 'spreadsheet',
         sheets: quarterlyPlanSheets()