@a3s-lab/office 0.26.0 → 0.27.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 { 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 { 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,137 @@ 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 WORDPROCESSINGML_NAMESPACES = new Set([
     'http://schemas.openxmlformats.org/wordprocessingml/2006/main',
     'http://purl.oclc.org/ooxml/wordprocessingml/main'
@@ -665,6 +796,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 +1875,12 @@ 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 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 +1910,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, 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',