@a3s-lab/office 0.12.0 → 0.13.0

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

@@ -1,12 +1,19 @@
-import { descendants, directChildren, directChild, OoxmlPackage, attribute, firstDescendant, contentTypeForPart } from "./5184.js";
-import { normalizeDocumentBookmarkName, docxBookmarkReferenceTarget, normalizeDocumentBookmarkNativeId, isDocumentParagraphArtBorderStyle, supportedDocxBookmarkReferenceInstruction, documentCitationTagsFromInstruction, docxDocumentFieldKind } from "./8928.js";
+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 { normalizeDocumentHref } from "./0~work-document-links.js";
 import { xmlAttributeLocalName, parseDocxParagraphDefaultCollapsed, readDocxBibliography, DOCX_WORDPROCESSING_NAMESPACES, xmlAttributeNamespace, createDocxThemeResolver } from "./0~2805.js";
-import { isSupportedXlsxCombinationChartNodes, MAX_XLSX_WORKSHEET_IMAGE_BYTES, inspectXlsxPivotTables, isSupportedXlsxWorksheetImageContentType, isSupportedXlsxChartLegend, isSupportedXlsxChartPlotLayout, xlsxChartNodeUsesStackedGrouping, isSupportedXlsxChartSeriesFormatting, readXlsxFormulaFeaturesFromPackage, inspectXlsxHeaderFooterText, isEditableXlsxPaperSizeCode, diagnoseXlsxProtection, xlsxChartSeriesFormattingShapeProperties } from "./4104.js";
+import { updateSpreadsheetWorksheetCompatibilitySummary, inspectXlsxPivotTables, isSupportedXlsxChartLegend, isSupportedXlsxChartPlotLayout, xlsxChartNodeUsesStackedGrouping, isSupportedXlsxChartSeriesFormatting, readXlsxFormulaFeaturesFromPackage, inspectXlsxHeaderFooterText, emptySpreadsheetWorksheetCompatibilitySummary, xlsxChartSeriesFormattingShapeProperties, MAX_XLSX_WORKSHEET_IMAGE_BYTES, isSupportedXlsxWorksheetImageContentType, xlsxWorksheetCellEntries, diagnoseXlsxProtection, isEditableXlsxPaperSizeCode, isSupportedXlsxCombinationChartNodes } from "./4104.js";
 import { spreadsheetConditionalComparisonNeedsUpperValue, isSpreadsheetConditionalIconSetName, isSpreadsheetConditionalComparisonOperator, spreadsheetConditionalIconSetCount } from "./4476.js";
 import { formulaHasStructuredReference, formulaHasExternalReference, parseSpreadsheetPrintTitles, volatileSpreadsheetFormulaFunctions, stripSpreadsheetSheetQualifier } from "./8715.js";
 import { unsupportedSpreadsheetFormulaFunctions } from "./0~work-spreadsheet-formula-support.js";
+var work_office_diagnostics_namespaceObject = {};
+__webpack_require__.r(work_office_diagnostics_namespaceObject);
+__webpack_require__.d(work_office_diagnostics_namespaceObject, {
+    analyzeDocxCompatibility: ()=>analyzeDocxCompatibility,
+    analyzeSpreadsheetCompatibility: ()=>analyzeSpreadsheetCompatibility
+});
 async function diagnoseDocxBookmarksAndLinks(archive, document) {
     const starts = descendants(document, 'bookmarkStart');
     const ends = descendants(document, 'bookmarkEnd');
@@ -1496,8 +1503,8 @@ function hasAdvancedDataBarVisuals(element) {
         'axisColor'
     ].some((name)=>descendants(element, name).length > 0);
 }
-async function diagnoseXlsxFormulas(archive) {
-    const features = await readXlsxFormulaFeaturesFromPackage(archive);
+async function diagnoseXlsxFormulas(archive, importedFeatures, worksheetScans) {
+    const features = importedFeatures ?? await readXlsxFormulaFeaturesFromPackage(archive, worksheetScans);
     const formulas = Array.from(features.sheets.entries()).flatMap(([sheetName, sheet])=>sheet.formulas.map((formula)=>({
                 ...formula,
                 sheetName
@@ -1608,8 +1615,8 @@ function work_xlsx_page_setup_diagnostics_issue(code, feature, message, severity
         severity
     };
 }
-async function diagnoseXlsxPivots(archive) {
-    const inspection = await inspectXlsxPivotTables(archive);
+async function diagnoseXlsxPivots(archive, importedInspection) {
+    const inspection = importedInspection ?? await inspectXlsxPivotTables(archive);
     const issues = [];
     if (inspection.tables.length) issues.push({
         code: 'xlsx.pivots',
@@ -1626,6 +1633,19 @@ async function diagnoseXlsxPivots(archive) {
     });
     return issues;
 }
+const XLSX_DIAGNOSTIC_WORKSHEET_ELEMENTS = [
+    'conditionalFormatting',
+    'dataValidation',
+    'sheetProtection',
+    'protectedRange',
+    'pageSetup',
+    'pageMargins',
+    'printOptions',
+    'headerFooter',
+    'pageSetUpPr',
+    'rowBreaks',
+    'colBreaks'
+];
 async function analyzeDocxCompatibility(file, messages, sourcePackage) {
     const issues = [
         work_office_diagnostics_issue('docx.page-layout', 'Page layout', 'Per-section paper size, orientation, exact native page margins, one-to-six equal or custom-width columns, section breaks, and explicit page breaks are preserved; exact pagination and line wrapping may normalize.'),
@@ -1724,7 +1744,7 @@ async function analyzeDocxCompatibility(file, messages, sourcePackage) {
     }
     return report(file, 'DOCX', issues);
 }
-async function analyzeSpreadsheetCompatibility(file, extension, workbook, sourcePackage) {
+async function analyzeSpreadsheetCompatibility(file, extension, workbook, sourcePackage, worksheetSummaries, importedMetadata) {
     if ('csv' === extension) return null;
     const sourceFormat = extension.toUpperCase();
     const issues = [];
@@ -1745,47 +1765,37 @@ async function analyzeSpreadsheetCompatibility(file, extension, workbook, source
     if (validPrintTitles.length < printTitles.length) issues.push(work_office_diagnostics_issue('sheet.print-titles.invalid', 'Print titles', 'One or more malformed print-title definitions remain in the original workbook only.'));
     for (const [index, name] of workbook.SheetNames.entries()){
         const worksheet = workbook.Sheets[name];
-        inspectWorksheetModel(worksheet, name, issues, 'xlsx' === extension);
+        inspectWorksheetModel(worksheet, name, issues, 'xlsx' === extension, worksheetSummaries?.get(name));
         if ((workbook.Workbook?.Sheets?.[index]?.Hidden ?? 0) > 0) issues.push(work_office_diagnostics_issue('sheet.hidden', 'Hidden worksheets', 'Hidden worksheet state is preserved but can be changed by the editor.', 'info', name));
     }
     if ('xlsx' === extension) try {
         const archive = void 0 === sourcePackage ? await OoxmlPackage.load(await file.arrayBuffer()) : sourcePackage;
         if (!archive) throw new Error('The XLSX package could not be loaded.');
-        await inspectXlsxPackage(archive, issues);
+        await inspectXlsxPackage(archive, issues, importedMetadata);
     } catch  {
         issues.push(work_office_diagnostics_issue('xlsx.inspect', 'Package inspection', 'Some XLSX features could not be inspected before conversion.'));
     }
     return issues.length ? report(file, sourceFormat, deduplicate(issues)) : null;
 }
-function inspectWorksheetModel(worksheet, name, issues, nativeXlsxFormulaInspection) {
+function inspectWorksheetModel(worksheet, name, issues, nativeXlsxFormulaInspection, importedSummary) {
     if (!worksheet) return;
     if (worksheet['!autofilter']) issues.push(work_office_diagnostics_issue('sheet.filter', 'Filters', 'The auto-filter range and hidden rows are preserved; advanced active criteria may be normalized.', 'info', name));
-    let hasComments = false;
-    let hasCommentThreads = false;
-    let hasLinks = false;
-    let hasArrayFormulas = false;
-    let hasRichText = false;
-    for (const [address, cell] of Object.entries(worksheet)){
-        if (address.startsWith('!') || !cell || 'object' != typeof cell) continue;
-        const source = cell;
-        if (source.c?.length) {
-            hasComments = true;
-            if (source.c.length > 1 || source.c.some((comment)=>comment.T)) hasCommentThreads = true;
-        }
-        if (source.l?.Target) hasLinks = true;
-        if (source.F) hasArrayFormulas = true;
-        if (source.r) hasRichText = true;
-    }
+    const { hasArrayFormulas, hasComments, hasCommentThreads, hasLinks, hasRichText } = importedSummary ?? summarizeSpreadsheetWorksheet(worksheet);
     if (hasComments) issues.push(work_office_diagnostics_issue('sheet.comments', 'Cell comments', 'Plain-text cell comments and one author are preserved and editable through the spreadsheet comment tools.', 'info', name));
     if (hasCommentThreads) issues.push(work_office_diagnostics_issue('sheet.comment-threads', 'Comment threads', 'Multiple comment blocks and threaded replies are flattened into one editable legacy comment.', 'warning', name));
     if (hasLinks) issues.push(work_office_diagnostics_issue('sheet.links', 'Cell hyperlinks', 'Web and in-workbook hyperlinks are preserved; advanced screen tips may be normalized.', 'info', name));
     if (hasArrayFormulas && !nativeXlsxFormulaInspection) issues.push(work_office_diagnostics_issue('sheet.array-formula', 'Array formulas', 'Array-formula ranges may be recalculated as ordinary formulas.', 'warning', name));
     if (hasRichText) issues.push(work_office_diagnostics_issue('sheet.rich-text', 'Rich cell text', 'Rich text inside a cell is converted to uniform text.', 'warning', name));
 }
-async function inspectXlsxPackage(archive, issues) {
+function summarizeSpreadsheetWorksheet(worksheet) {
+    const summary = emptySpreadsheetWorksheetCompatibilitySummary();
+    for (const { cell } of xlsxWorksheetCellEntries(worksheet))updateSpreadsheetWorksheetCompatibilitySummary(summary, cell);
+    return summary;
+}
+async function inspectXlsxPackage(archive, issues, importedMetadata) {
     issues.push(...await diagnoseXlsxCharts(archive));
-    issues.push(...await diagnoseXlsxFormulas(archive));
-    issues.push(...await diagnoseXlsxPivots(archive));
+    issues.push(...await diagnoseXlsxFormulas(archive, importedMetadata?.formulaFeatures, importedMetadata?.worksheetScans));
+    issues.push(...await diagnoseXlsxPivots(archive, importedMetadata?.pivotFeatures));
     const drawingParts = archive.paths('xl/drawings/').filter((path)=>/^xl\/drawings\/drawing\d+\.xml$/i.test(path));
     let preservedImages = 0;
     let hasUnsupportedImages = false;
@@ -1837,7 +1847,11 @@ async function inspectXlsxPackage(archive, issues) {
     }
     for (const part of archive.paths('xl/worksheets/')){
         if (!part.endsWith('.xml')) continue;
-        const worksheet = await archive.xml(part);
+        const scan = importedMetadata?.worksheetScans?.[part];
+        if (scan && !scan.hasDiagnosticFeatures) continue;
+        const source = await archive.text(part);
+        if (!scan && !xmlContainsAnyElement(source, XLSX_DIAGNOSTIC_WORKSHEET_ELEMENTS)) continue;
+        const worksheet = parseXml(source, part);
         if (descendants(worksheet, 'conditionalFormatting').length) for (const diagnostic of diagnoseXlsxConditionalFormatting(worksheet, styles))issues.push(work_office_diagnostics_issue(diagnostic.code, 'Conditional formatting', diagnostic.message, diagnostic.severity));
         if (descendants(worksheet, 'dataValidation').length) issues.push(work_office_diagnostics_issue('xlsx.validation', 'Data validation', 'Common list, numeric, date, and text-length rules are editable; custom formulas and very large ranges may be normalized.', 'info'));
         if (descendants(worksheet, 'sheetProtection').length || descendants(worksheet, 'protectedRange').length) for (const diagnostic of diagnoseXlsxProtection(worksheet, styles))issues.push(work_office_diagnostics_issue(diagnostic.code, 'Sheet protection', diagnostic.message, diagnostic.severity));
@@ -1874,4 +1888,4 @@ function deduplicate(issues) {
         return true;
     });
 }
-export { analyzeDocxCompatibility, analyzeSpreadsheetCompatibility };
+export { work_office_diagnostics_namespaceObject };