@a3s-lab/office 0.26.0 → 0.28.0

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

@@ -1,11 +1,11 @@
 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, docxFieldOccurrences, inspectDocxEquation, inspectDocxPageMarginSettings, markDocxParagraphBorders, isSupportedDocxParagraphFormattingChange, docxFieldOccurrenceIsInlineEditable, 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, parseDocxParagraphDefaultCollapsed, readDocxBibliography, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, createDocxThemeResolver } from "./0~2805.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";
-import { spreadsheetConditionalComparisonNeedsUpperValue, isSpreadsheetConditionalIconSetName, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconSetCount, xlsxWorksheetCellEntries } from "./164.js";
+import { spreadsheetConditionalComparisonNeedsUpperValue, isSpreadsheetConditionalIconSetName, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconSetCount, xlsxWorksheetCellEntries } from "./1544.js";
 import { formulaHasStructuredReference, formulaHasExternalReference, parseSpreadsheetPrintTitles, volatileSpreadsheetFormulaFunctions, stripSpreadsheetSheetQualifier } from "./8715.js";
 import { unsupportedSpreadsheetFormulaFunctions } from "./0~work-spreadsheet-formula-support.js";
 var work_office_diagnostics_namespaceObject = {};
@@ -269,6 +269,187 @@ function equationIssue(code, message, severity = 'warning') {
         severity
     };
 }
+const EMPHASIS_DIAGNOSTIC_PART_PATTERN = /^word\/(?:document|styles|header\d*|footer\d*|footnotes|endnotes)\.xml$/i;
+async function diagnoseDocxEmphasisMarks(archive, document) {
+    const parts = [
+        {
+            path: 'word/document.xml',
+            document
+        }
+    ];
+    for (const path of archive.paths('word/'))if ('word/document.xml' !== path.toLowerCase() && EMPHASIS_DIAGNOSTIC_PART_PATTERN.test(path)) parts.push({
+        path,
+        document: await archive.xml(path)
+    });
+    let validCount = 0;
+    let explicitNoneCount = 0;
+    let underDotCount = 0;
+    let invalidCount = 0;
+    for (const part of parts){
+        const propertySets = descendants(part.document, 'rPr').filter((element)=>DOCX_WORDPROCESSING_NAMESPACES.has(element.namespaceURI ?? ''));
+        for (const properties of propertySets){
+            if (!directChildren(properties, 'em').length) continue;
+            const inspection = inspectDocxEmphasisMark(properties);
+            if ('valid' === inspection.status) {
+                validCount += 1;
+                if ('none' === inspection.value) explicitNoneCount += 1;
+                if ('underDot' === inspection.value) underDotCount += 1;
+            } else if ('invalid' === inspection.status) invalidCount += 1;
+        }
+        invalidCount += descendants(part.document, 'em').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.emphasis-mark',
+        severity: 'info',
+        feature: 'East Asian emphasis marks',
+        message: `${validCount} native emphasis mark(s), including ${explicitNoneCount} explicit none reset(s) and ${underDotCount} below-text dot(s), preserve all five w:em values through style inheritance, body and page-chrome editing, formatting revisions, CSS projection, and DOCX export. Runs with visible marks use browser line measurement so their out-of-line glyph extents are not approximated by the Worker/WASM shaper.`
+    });
+    if (invalidCount) issues.push({
+        code: 'docx.emphasis-mark.invalid',
+        severity: 'warning',
+        feature: 'East Asian emphasis marks',
+        message: `${invalidCount} malformed, duplicated, misplaced, namespace-spoofed, text-bearing, or unknown emphasis property set(s) are ignored instead of enabling untrusted typography.`
+    });
+    return issues;
+}
+const HIDDEN_TEXT_DIAGNOSTIC_PART_PATTERN = /^word\/(?:document|styles|header\d*|footer\d*|footnotes|endnotes|comments)\.xml$/i;
+async function diagnoseDocxHiddenText(archive, document) {
+    const parts = [
+        document
+    ];
+    for (const path of archive.paths('word/'))if ('word/document.xml' !== path.toLowerCase() && HIDDEN_TEXT_DIAGNOSTIC_PART_PATTERN.test(path)) parts.push(await archive.xml(path));
+    let hiddenCount = 0;
+    let visibleResetCount = 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 (!directChildren(properties, 'vanish').length) continue;
+            const inspection = inspectDocxHiddenText(properties);
+            if ('valid' === inspection.status) if (inspection.value) hiddenCount += 1;
+            else visibleResetCount += 1;
+            else if ('invalid' === inspection.status) invalidCount += 1;
+        }
+        invalidCount += descendants(part, 'vanish').filter((element)=>{
+            const parent = element.parentElement;
+            return !parent || 'rPr' !== parent.localName || !DOCX_WORDPROCESSING_NAMESPACES.has(parent.namespaceURI ?? '');
+        }).length;
+    }
+    const issues = [];
+    const validCount = hiddenCount + visibleResetCount;
+    if (validCount) issues.push({
+        code: 'docx.hidden-text',
+        severity: 'info',
+        feature: 'Hidden text',
+        message: `${validCount} native hidden-text value(s), including ${hiddenCount} hidden value(s) and ${visibleResetCount} explicit visible reset(s), were detected across document defaults, character and paragraph styles, body, headers, footers, notes, comments, and formatting revisions. Editable Writer stories preserve w:vanish through the Font dialog, the show-hidden-text editing view, and exact DOCX export; unchanged comment XML remains source-preserved rather than becoming a rich comment-editing claim. Preview and PDF output keep hidden text suppressed, while affected paragraphs use browser-authoritative line measurement.`
+    });
+    if (invalidCount) issues.push({
+        code: 'docx.hidden-text.invalid',
+        severity: 'warning',
+        feature: 'Hidden text',
+        message: `${invalidCount} malformed, duplicated, misplaced, namespace-spoofed, text-bearing, child-bearing, extra-attribute, or unknown hidden-text property set(s) are ignored instead of hiding untrusted content.`
+    });
+    return issues;
+}
+const KERNING_DIAGNOSTIC_PART_PATTERN = /^word\/(?:document|styles|header\d*|footer\d*|footnotes|endnotes)\.xml$/i;
+async function diagnoseDocxKerning(archive, document) {
+    const parts = [
+        {
+            path: 'word/document.xml',
+            document
+        }
+    ];
+    for (const path of archive.paths('word/'))if ('word/document.xml' !== path.toLowerCase() && KERNING_DIAGNOSTIC_PART_PATTERN.test(path)) parts.push({
+        path,
+        document: await archive.xml(path)
+    });
+    let validCount = 0;
+    let explicitZeroCount = 0;
+    let invalidCount = 0;
+    for (const part of parts){
+        const propertySets = descendants(part.document, 'rPr').filter((element)=>DOCX_WORDPROCESSING_NAMESPACES.has(element.namespaceURI ?? ''));
+        for (const properties of propertySets){
+            if (!directChildren(properties, 'kern').length) continue;
+            const inspection = inspectDocxKerningThresholdHalfPoints(properties);
+            if ('valid' === inspection.status) {
+                validCount += 1;
+                if (0 === inspection.value) explicitZeroCount += 1;
+            } else if ('invalid' === inspection.status) invalidCount += 1;
+        }
+        invalidCount += descendants(part.document, 'kern').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.kerning',
+        severity: 'info',
+        feature: 'Character kerning',
+        message: `${validCount} native kerning threshold(s), including ${explicitZeroCount} explicit all-font-size value(s), preserve exact half-points through style inheritance, body and page-chrome editing, effective font-size rendering, formatting revisions, and DOCX export. Pair kerning applies when the effective w:sz value meets or exceeds w:kern; absence throughout the hierarchy keeps kerning disabled.`
+    });
+    if (invalidCount) issues.push({
+        code: 'docx.kerning.invalid',
+        severity: 'warning',
+        feature: 'Character kerning',
+        message: `${invalidCount} malformed, duplicated, misplaced, namespace-spoofed, text-bearing, or out-of-range kerning property set(s) are ignored instead of enabling untrusted typography.`
+    });
+    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'
@@ -665,6 +846,63 @@ async function diagnoseDocxParagraphShading(archive, document) {
     });
     return issues;
 }
+const RUN_FONT_DIAGNOSTIC_PART_PATTERN = /^word\/(?:document|styles|header\d*|footer\d*|footnotes|endnotes|comments)\.xml$/i;
+async function diagnoseDocxRunFonts(archive, document) {
+    const parts = [
+        {
+            path: 'word/document.xml',
+            document
+        }
+    ];
+    for (const path of archive.paths('word/'))if ('word/document.xml' !== path.toLowerCase() && RUN_FONT_DIAGNOSTIC_PART_PATTERN.test(path)) parts.push({
+        path,
+        document: await archive.xml(path)
+    });
+    let validCount = 0;
+    let directSlotCount = 0;
+    let themeSlotCount = 0;
+    let hintCount = 0;
+    let invalidCount = 0;
+    for (const part of parts){
+        const propertySets = descendants(part.document, 'rPr').filter((element)=>DOCX_WORDPROCESSING_NAMESPACES.has(element.namespaceURI ?? ''));
+        for (const properties of propertySets){
+            if (!directChildren(properties, 'rFonts').length) continue;
+            const inspection = inspectDocxRunFonts(properties);
+            if ('valid' === inspection.status) {
+                validCount += 1;
+                if (!inspection.value) continue;
+                for (const slot of [
+                    inspection.value.ascii,
+                    inspection.value.highAnsi,
+                    inspection.value.eastAsia,
+                    inspection.value.complexScript
+                ]){
+                    if (slot?.name) directSlotCount += 1;
+                    if (slot?.theme) themeSlotCount += 1;
+                }
+                if (inspection.value.hint) hintCount += 1;
+            } else if ('invalid' === inspection.status) invalidCount += 1;
+        }
+        invalidCount += descendants(part.document, 'rFonts').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.script-fonts",
+        severity: 'info',
+        feature: 'Script-specific run fonts',
+        message: `${validCount} native run-font property set(s), containing ${directSlotCount} direct slot value(s), ${themeSlotCount} theme slot reference(s), and ${hintCount} script hint(s), preserve the independent ASCII, high ANSI, East Asian, and complex-script identities through style inheritance, mixed-script browser rendering, body and page-chrome editing, formatting revisions, and DOCX export. Browser-resolved families remain separate from native source identity so font substitution does not rewrite untouched theme references.`
+    });
+    if (invalidCount) issues.push({
+        code: "docx.script-fonts.invalid",
+        severity: 'warning',
+        feature: 'Script-specific run fonts',
+        message: `${invalidCount} malformed, duplicated, misplaced, namespace-spoofed, child-bearing, text-bearing, unknown, or oversized run-font property set(s) are ignored instead of applying untrusted font metadata.`
+    });
+    return issues;
+}
 const SUPPORTED_CHART_ELEMENTS = new Set([
     'barChart',
     'lineChart',
@@ -1687,6 +1925,13 @@ async function analyzeDocxCompatibility(file, messages, sourcePackage) {
         }
         issues.push(...await diagnoseDocxNotes(archive, document));
         issues.push(...await diagnoseDocxEquations(archive, document));
+        if (document) {
+            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));
         if (archive.paths('word/embeddings/').length) issues.push(work_office_diagnostics_issue('docx.embedded', 'Embedded objects', 'Embedded Office and OLE payload parts plus safe relationships are retained in source-backed exports, but Work does not render or edit their object anchors; placement inside regenerated document XML may normalize.'));
         if (document) {
@@ -1716,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, 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',