@qianxiang-ai/fu-report-viewer-engine 0.0.0-stage → 1.1.7

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types.js';
+export { convertLegacyViewerModel, parseLegacyRichText } from './legacy-converter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './types.js';
+export { convertLegacyViewerModel, parseLegacyRichText } from './legacy-converter.js';

package/dist/legacy-converter.d.ts

@@ -0,0 +1,5 @@
+import type { ViewerRenderModel } from '@qianxiang-ai/fu-report-contracts';
+import type { NativeConversionOptions, NativeRichTextNode, NativeViewerDocument } from './types.js';
+export declare function convertLegacyViewerModel(model: ViewerRenderModel, options?: NativeConversionOptions): NativeViewerDocument;
+export declare function parseLegacyRichText(value: unknown, depth?: number): readonly NativeRichTextNode[];
+//# sourceMappingURL=legacy-converter.d.ts.map

package/dist/legacy-converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-converter.d.ts","sourceRoot":"","sources":["../src/legacy-converter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAA;AAC1E,OAAO,KAAK,EAMV,uBAAuB,EAKvB,kBAAkB,EAClB,oBAAoB,EAErB,MAAM,YAAY,CAAA;AA4BnB,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,uBAA4B,GACpC,oBAAoB,CAgBtB;AAyKD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,SAAS,kBAAkB,EAAE,CA4B5F"}

package/dist/legacy-converter.js

@@ -0,0 +1,667 @@
+const DATASET_REFERENCE_SOURCE = '[#$]\\{([A-Za-z_][A-Za-z0-9_.-]{0,127})\\.([A-Za-z_][A-Za-z0-9_.-]{0,127})\\}(\\.group\\(\\))?';
+const DATASET_REFERENCE = new RegExp(DATASET_REFERENCE_SOURCE, 'g');
+const EXACT_DATASET_REFERENCE = new RegExp(`^${DATASET_REFERENCE_SOURCE}$`);
+const ROW_EXPRESSION = /^=ROW\(\s*\)$/i;
+const SAFE_COLOR = /^(?:#[0-9a-fA-F]{3,8}|rgba?\([0-9.,%\s]+\)|transparent)$/;
+const MAX_TRACKS = 50_000;
+export function convertLegacyViewerModel(model, options = {}) {
+    const root = object(model.renderTree);
+    const sheets = sourceSheets(root).map(item => convertSheet(item, options));
+    if (sheets.length === 0) {
+        sheets.push(convertSheet({ id: 'default', name: model.title, order: 0, document: {} }, options));
+    }
+    const requested = string(root.activeSheetId, sheets[0]?.id ?? 'default');
+    const activeSheetId = sheets.some(sheet => sheet.id === requested) ? requested : sheets[0].id;
+    return deepFreeze({
+        schemaVersion: 'native-v1',
+        reportId: model.reportId,
+        revision: model.revision,
+        title: model.title,
+        activeSheetId,
+        sheets
+    });
+}
+function sourceSheets(root) {
+    if (!Array.isArray(root.sheets)) {
+        return [{ id: 'default', name: string(root.name, '默认 Sheet'), order: 0, document: root }];
+    }
+    return root.sheets.slice(0, 256).map((value, index) => {
+        const sheet = object(value);
+        return {
+            id: safeIdentifier(sheet.id, index === 0 ? 'default' : `sheet-${index}`),
+            name: string(sheet.name, `Sheet ${index + 1}`).slice(0, 128),
+            order: integer(sheet.order, index),
+            document: object(sheet.document)
+        };
+    }).sort((left, right) => left.order - right.order);
+}
+function convertSheet(source, options) {
+    const document = source.document;
+    const defaultRowHeight = clamp(number(options.defaultRowHeight, 26), 12, 240);
+    const defaultColumnWidth = clamp(number(options.defaultColumnWidth, 100), 24, 1000);
+    const expanded = expandRows(object(document.rows), options.datasets ?? {}, defaultRowHeight);
+    const expandedRowShift = Math.max(0, ...expanded.map(row => row.outputRow - row.sourceRow));
+    const rowCount = clamp(Math.max(1, ...expanded.map(row => row.outputRow + 1), areaEnd(document, 'eri') + 1 + expandedRowShift), 1, MAX_TRACKS);
+    const columnCount = clamp(Math.max(1, maxCellColumn(expanded) + 1, areaEnd(document, 'eci') + 1), 1, 2048);
+    const hidden = object(document.hidden);
+    const hiddenRows = integerSet(hidden.rows);
+    const hiddenColumns = integerSet(hidden.cols);
+    const rows = tracks(rowCount, defaultRowHeight, index => {
+        const row = expanded.find(item => item.outputRow === index);
+        return row?.height ?? defaultRowHeight;
+    }, hiddenRows);
+    const columnsSource = object(document.cols);
+    const columns = tracks(columnCount, defaultColumnWidth, index => number(object(columnsSource[String(index)]).width, defaultColumnWidth), hiddenColumns);
+    const sourceToOutput = new Map();
+    expanded.forEach(row => {
+        if (!sourceToOutput.has(row.sourceRow))
+            sourceToOutput.set(row.sourceRow, row.outputRow);
+    });
+    const merges = mergeRanges(document, expanded, sourceToOutput);
+    const covered = coveredCells(merges);
+    const styles = Array.isArray(document.styles) ? document.styles.map(object) : [];
+    const cells = [];
+    for (const row of expanded) {
+        for (const [columnKey, rawCell] of Object.entries(row.cells)) {
+            const column = integer(columnKey, -1);
+            if (column < 0 || column >= columns.length || covered.has(`${row.outputRow}:${column}`))
+                continue;
+            const cell = object(rawCell);
+            const merge = merges.find(item => item.row === row.outputRow && item.column === column);
+            const rowspan = merge?.rowspan ?? 1;
+            const colspan = merge?.colspan ?? 1;
+            const bounds = cellBounds(rows, columns, row.outputRow, column, rowspan, colspan);
+            const style = normalizeStyle(styles[integer(cell.style, -1)] ?? object(cell.style));
+            const padding = normalizePadding(cell.padding ?? styles[integer(cell.style, -1)]?.padding);
+            const value = resolveCellValue(cell, row, options.datasets ?? {});
+            if (cell.virtual && value.text.trim() === '')
+                continue;
+            cells.push({
+                id: `cell-${row.outputRow}-${column}`,
+                row: row.outputRow,
+                column,
+                rowspan,
+                colspan,
+                bounds,
+                contentBox: inset(bounds, padding),
+                zIndex: integer(cell.zIndex, 1),
+                text: value.text,
+                richText: value.richText,
+                hyperlink: safeLink(cell.hyperlink ?? cell.link),
+                style,
+                dynamicGroup: value.dynamicGroup
+            });
+        }
+    }
+    collapseDynamicGroups(cells, rows);
+    const visibleCells = cells.filter(cell => cell.rowspan > 0).map(({ dynamicGroup: _ignored, ...cell }) => cell);
+    const layers = convertLayers(document, rows, columns, sourceToOutput);
+    const width = columns.reduce((sum, track) => sum + track.size, 0);
+    const height = rows.reduce((sum, track) => sum + track.size, 0);
+    return {
+        id: source.id,
+        name: source.name,
+        order: source.order,
+        width,
+        height,
+        rows,
+        columns,
+        cells: visibleCells,
+        layers,
+        pages: paginate(rows, object(document.printConfig)),
+        frozen: freezePoint(string(document.freeze, ''), rows, columns)
+    };
+}
+function expandRows(rows, datasets, defaultHeight) {
+    const sourceIndexes = Object.keys(rows).map(value => integer(value, -1))
+        .filter(value => value >= 0).sort((a, b) => a - b);
+    const result = [];
+    let outputRow = 0;
+    let previousSourceRow = -1;
+    for (const sourceRow of sourceIndexes) {
+        outputRow += Math.max(0, sourceRow - previousSourceRow - 1);
+        const row = object(rows[String(sourceRow)]);
+        const cells = object(row.cells);
+        const binding = findRowBinding(cells);
+        const data = binding ? datasets[binding] : undefined;
+        const repetitions = data ? (data.length ? [...data] : [undefined]) : [undefined];
+        for (const [datasetIndex, datasetRow] of repetitions.entries()) {
+            result.push({
+                sourceRow,
+                outputRow: outputRow++,
+                datasetIndex,
+                height: clamp(number(row.height, defaultHeight), 0, 1000),
+                cells,
+                datasetRow,
+                binding
+            });
+        }
+        previousSourceRow = sourceRow;
+    }
+    return result;
+}
+function findRowBinding(cells) {
+    for (const value of Object.values(cells)) {
+        const match = DATASET_REFERENCE.exec(string(object(value).text, ''));
+        DATASET_REFERENCE.lastIndex = 0;
+        if (match?.[1])
+            return match[1];
+    }
+    return undefined;
+}
+function resolveCellValue(cell, row, datasets) {
+    const raw = cell.text ?? cell.value ?? '';
+    const text = string(raw, '');
+    if (ROW_EXPRESSION.test(text.trim())) {
+        return { text: String(row.binding ? row.datasetIndex + 1 : row.outputRow + 1) };
+    }
+    const expression = EXACT_DATASET_REFERENCE.exec(text);
+    if (expression?.[1] && expression[2]) {
+        return {
+            text: datasetValue(expression[1], expression[2], row, datasets),
+            dynamicGroup: expression[3] ? `${expression[1]}.${expression[2]}` : undefined
+        };
+    }
+    const resolvedText = text.replace(DATASET_REFERENCE, (_match, binding, field) => datasetValue(binding, field, row, datasets));
+    const richTextSource = cell.richText ?? (cell.display === 'richText' ? resolvedText : undefined);
+    const richText = richTextSource === undefined ? undefined : parseLegacyRichText(richTextSource);
+    return { text: resolvedText.slice(0, 100_000), richText };
+}
+function datasetValue(binding, field, row, datasets) {
+    const source = binding === row.binding ? row.datasetRow : datasets[binding]?.[0];
+    const value = source?.[field];
+    return value == null ? '' : String(value);
+}
+export function parseLegacyRichText(value, depth = 0) {
+    if (depth > 12)
+        return [];
+    if (typeof value === 'string') {
+        const text = value.slice(0, 100_000);
+        return /<\/?[a-z][^>]*>/i.test(text) ? parseLegacyHtmlRichText(text) : [{ type: 'text', text }];
+    }
+    const values = Array.isArray(value) ? value : [value];
+    const result = [];
+    for (const raw of values.slice(0, 10_000)) {
+        if (typeof raw === 'string') {
+            result.push({ type: 'text', text: raw.slice(0, 100_000) });
+            continue;
+        }
+        const node = object(raw);
+        const type = string(node.type, 'text');
+        if (type === 'br' || type === 'lineBreak') {
+            result.push({ type: 'lineBreak' });
+        }
+        else if (['div', 'paragraph', 'span', 'strong', 'emphasis', 'em'].includes(type)) {
+            result.push({
+                type: type === 'em' ? 'emphasis' : type,
+                children: parseLegacyRichText(node.children ?? node.content ?? [], depth + 1),
+                style: sanitizeRichTextStyle(node.style)
+            });
+        }
+        else {
+            result.push({ type: 'text', text: string(node.text, '').slice(0, 100_000) });
+        }
+    }
+    return result;
+}
+function parseLegacyHtmlRichText(value) {
+    const root = [];
+    const stack = [{ tag: 'root', children: root }];
+    const tokens = value.match(/<!--[\s\S]*?-->|<[^>]*>|[^<]+/g) ?? [];
+    for (const token of tokens.slice(0, 20_000)) {
+        if (!token.startsWith('<')) {
+            stack[stack.length - 1].children.push({ type: 'text', text: decodeHtmlEntities(token) });
+            continue;
+        }
+        if (token.startsWith('<!--') || /^<!/i.test(token))
+            continue;
+        const closing = /^<\s*\/\s*([a-z0-9]+)/i.exec(token);
+        if (closing?.[1]) {
+            const tag = closing[1].toLowerCase();
+            while (stack.length > 1) {
+                const current = stack.pop();
+                if (current?.tag === tag)
+                    break;
+            }
+            continue;
+        }
+        const opening = /^<\s*([a-z0-9]+)/i.exec(token);
+        if (!opening?.[1])
+            continue;
+        const tag = opening[1].toLowerCase();
+        if (tag === 'br') {
+            stack[stack.length - 1].children.push({ type: 'lineBreak' });
+            continue;
+        }
+        const type = richTextElementType(tag);
+        if (!type)
+            continue;
+        const children = [];
+        const styleMatch = /\bstyle\s*=\s*(["'])([\s\S]*?)\1/i.exec(token);
+        const style = sanitizeRichTextStyle(styleMatch?.[2]);
+        const node = { type, children, ...(Object.keys(style).length ? { style } : {}) };
+        stack[stack.length - 1].children.push(node);
+        if (!/\/\s*>$/.test(token))
+            stack.push({ tag, node, children });
+    }
+    return root;
+}
+function richTextElementType(tag) {
+    if (tag === 'div')
+        return 'div';
+    if (tag === 'p')
+        return 'paragraph';
+    if (tag === 'span')
+        return 'span';
+    if (tag === 'strong' || tag === 'b')
+        return 'strong';
+    if (tag === 'em' || tag === 'i')
+        return 'emphasis';
+    return undefined;
+}
+function sanitizeRichTextStyle(value) {
+    const source = typeof value === 'string'
+        ? value
+        : Object.entries(object(value)).map(([key, item]) => `${key}:${String(item)}`).join(';');
+    const result = {};
+    for (const declaration of source.split(';').slice(0, 64)) {
+        const separator = declaration.indexOf(':');
+        if (separator < 1)
+            continue;
+        const key = declaration.slice(0, separator).trim().toLowerCase();
+        const raw = declaration.slice(separator + 1).trim();
+        const name = RICH_TEXT_STYLE_NAMES[key];
+        if (!name || !safeRichTextStyleValue(key, raw))
+            continue;
+        result[name] = raw;
+    }
+    return result;
+}
+const RICH_TEXT_STYLE_NAMES = {
+    'background': 'background', 'background-color': 'backgroundColor', 'box-sizing': 'boxSizing',
+    'color': 'color', 'display': 'display', 'font-size': 'fontSize', 'font-style': 'fontStyle',
+    'font-weight': 'fontWeight', 'height': 'height', 'line-height': 'lineHeight', 'margin': 'margin',
+    'margin-bottom': 'marginBottom', 'margin-left': 'marginLeft', 'margin-right': 'marginRight',
+    'margin-top': 'marginTop', 'padding': 'padding', 'padding-bottom': 'paddingBottom',
+    'padding-left': 'paddingLeft', 'padding-right': 'paddingRight', 'padding-top': 'paddingTop',
+    'text-align': 'textAlign', 'text-decoration': 'textDecoration', 'width': 'width'
+};
+function safeRichTextStyleValue(key, value) {
+    if (!value || value.length > 128 || /url\s*\(|expression\s*\(|javascript:|@import|var\s*\(/i.test(value))
+        return false;
+    if (key === 'color' || key === 'background' || key === 'background-color') {
+        return /^(?:#[0-9a-f]{3,8}|rgba?\([\d\s.,%]+\)|transparent|black|white)$/i.test(value);
+    }
+    if (key === 'box-sizing')
+        return /^(?:border-box|content-box)$/.test(value);
+    if (key === 'display')
+        return /^(?:block|inline|inline-block|flex)$/.test(value);
+    if (key === 'font-style')
+        return /^(?:normal|italic|oblique)$/.test(value);
+    if (key === 'font-weight')
+        return /^(?:normal|bold|[1-9]00)$/.test(value);
+    if (key === 'text-align')
+        return /^(?:left|center|right|justify)$/.test(value);
+    if (key === 'text-decoration')
+        return /^(?:none|underline|line-through)$/.test(value);
+    return /^(?:-?\d+(?:\.\d+)?(?:px|em|rem|%|vh|vw)?|auto)(?:\s+(?:-?\d+(?:\.\d+)?(?:px|em|rem|%|vh|vw)?|auto)){0,3}$/.test(value);
+}
+function decodeHtmlEntities(value) {
+    return value.replace(/&(?:amp|lt|gt|quot|#39);/g, entity => ({
+        '&amp;': '&', '&lt;': '<', '&gt;': '>', '&quot;': '"', '&#39;': "'"
+    })[entity] ?? entity);
+}
+function mergeRanges(document, rows, sourceToOutput) {
+    const result = [];
+    if (Array.isArray(document.merges)) {
+        for (const merge of document.merges.slice(0, 100_000)) {
+            const parsed = parseA1Range(string(merge, ''));
+            if (!parsed)
+                continue;
+            const start = sourceToOutput.get(parsed.row) ?? parsed.row;
+            const end = sourceToOutput.get(parsed.endRow) ?? parsed.endRow;
+            result.push({ row: start, column: parsed.column, rowspan: end - start + 1, colspan: parsed.endColumn - parsed.column + 1 });
+        }
+    }
+    for (const row of rows) {
+        for (const [columnKey, raw] of Object.entries(row.cells)) {
+            const merge = object(raw).merge;
+            if (!Array.isArray(merge) || merge.length < 2)
+                continue;
+            const rowspan = clamp(integer(merge[0], 0) + 1, 1, 10_000);
+            const colspan = clamp(integer(merge[1], 0) + 1, 1, 2048);
+            result.push({ row: row.outputRow, column: integer(columnKey, 0), rowspan, colspan });
+        }
+    }
+    const unique = new Map(result.map(item => [`${item.row}:${item.column}`, item]));
+    return [...unique.values()];
+}
+function coveredCells(merges) {
+    const covered = new Set();
+    for (const merge of merges) {
+        for (let row = merge.row; row < merge.row + merge.rowspan; row++) {
+            for (let column = merge.column; column < merge.column + merge.colspan; column++) {
+                if (row !== merge.row || column !== merge.column)
+                    covered.add(`${row}:${column}`);
+            }
+        }
+    }
+    return covered;
+}
+function collapseDynamicGroups(cells, rows) {
+    const groups = new Map();
+    for (const cell of cells) {
+        if (!cell.dynamicGroup)
+            continue;
+        const key = `${cell.column}:${cell.dynamicGroup}`;
+        const list = groups.get(key) ?? [];
+        list.push(cell);
+        groups.set(key, list);
+    }
+    for (const list of groups.values()) {
+        list.sort((a, b) => a.row - b.row);
+        let anchor;
+        for (const cell of list) {
+            if (anchor && cell.row === anchor.row + anchor.rowspan && cell.text === anchor.text) {
+                anchor.rowspan += 1;
+                anchor.bounds = { ...anchor.bounds, height: anchor.bounds.height + (rows[cell.row]?.size ?? 0) };
+                anchor.contentBox = { ...anchor.contentBox, height: Math.max(0, anchor.contentBox.height + (rows[cell.row]?.size ?? 0)) };
+                cell.rowspan = 0;
+            }
+            else {
+                anchor = cell;
+            }
+        }
+    }
+}
+function convertLayers(document, rows, columns, sourceToOutput) {
+    const result = [];
+    let zIndex = 10;
+    const addBase = (raw, type) => {
+        const item = object(raw);
+        const row = sourceToOutput.get(integer(item.row, 0)) ?? integer(item.row, 0);
+        const column = integer(item.col, 0);
+        const natural = cellBounds(rows, columns, row, column, clamp(integer(item.rowspan, 1), 1, 10_000), clamp(integer(item.colspan, 1), 1, 2048));
+        const bounds = {
+            x: natural.x + number(item.offsetX, 0),
+            y: natural.y + number(item.offsetY, 0),
+            width: clamp(number(item.width, natural.width), 1, 100_000),
+            height: clamp(number(item.height, natural.height), 1, 100_000)
+        };
+        return { item, id: safeIdentifier(item.layer_id, `${type}-${zIndex}`), bounds, contentBox: inset(bounds, [4, 4, 4, 4]), zIndex: zIndex++, type };
+    };
+    for (const raw of arrays(document.imgList, document.images)) {
+        const base = addBase(raw, 'image');
+        const source = safeResource(base.item.src ?? base.item.source);
+        if (source)
+            result.push({ ...base, type: 'image', source, alt: string(base.item.alt, '报表图片').slice(0, 512) });
+    }
+    for (const raw of arrays(document.chartList, document.charts)) {
+        const item = object(raw);
+        const config = parseObject(item.config);
+        const series = Array.isArray(config.series) ? object(config.series[0]) : {};
+        const rawChartType = string(series.type, string(object(item.extData).chartType, 'bar'));
+        if (rawChartType === 'map') {
+            const base = addBase(raw, 'map');
+            const points = (Array.isArray(series.data) ? series.data : []).slice(0, 2000).map(value => {
+                const point = object(value);
+                return { name: string(point.name, ''), value: number(point.value, 0) };
+            });
+            result.push({ ...base, type: 'map', title: string(object(config.title).text, ''), points });
+        }
+        else {
+            const base = addBase(raw, 'chart');
+            const data = (Array.isArray(series.data) ? series.data : []).slice(0, 2000);
+            const axisCategories = Array.isArray(object(config.xAxis).data) ? object(config.xAxis).data : [];
+            const categories = data.map((value, index) => string(object(value).name, string(axisCategories[index], String(index + 1))));
+            const values = data.map(value => number(object(value).value ?? value, 0));
+            result.push({
+                ...base,
+                type: 'chart',
+                chartType: normalizeChartType(rawChartType),
+                title: string(object(config.title).text, ''),
+                categories,
+                values
+            });
+        }
+    }
+    for (const raw of arrays(document.barcodeList)) {
+        const base = addBase(raw, 'barcode');
+        const config = parseObject(base.item.jsonString);
+        result.push({
+            ...base,
+            type: 'barcode',
+            text: string(config.barcodeContent ?? config.text, '').slice(0, 2048),
+            label: string(config.text ?? config.barcodeContent, '').slice(0, 2048),
+            color: color(config.lineColor, '#000000'),
+            background: color(config.background, '#ffffff'),
+            displayValue: config.displayValue !== false,
+            fontSize: clamp(number(config.fontSize, 14), 6, 96)
+        });
+    }
+    for (const raw of arrays(document.qrcodeList)) {
+        const base = addBase(raw, 'qrcode');
+        const config = parseObject(base.item.jsonString);
+        result.push({
+            ...base,
+            type: 'qrcode',
+            text: string(config.text, '').slice(0, 4096),
+            color: color(config.colorDark, '#000000'),
+            background: color(config.colorLight, '#ffffff')
+        });
+    }
+    for (const raw of arrays(document.richTextList)) {
+        const base = addBase(raw, 'richText');
+        result.push({ ...base, type: 'richText', nodes: parseLegacyRichText(base.item.content ?? base.item.text) });
+    }
+    return result.sort((a, b) => a.zIndex - b.zIndex);
+}
+function normalizeChartType(value) {
+    if (value === 'line' || value === 'pie' || value === 'scatter' || value === 'funnel'
+        || value === 'radar' || value === 'gauge' || value === 'pictorialBar')
+        return value;
+    return 'bar';
+}
+function paginate(rows, config) {
+    const paperHeightMm = string(config.layout, 'portrait') === 'landscape'
+        ? number(config.width, 297) : number(config.height, 297);
+    const margin = clamp(number(config.marginY, 10), 0, paperHeightMm / 3);
+    const pageHeight = Math.max(96, (paperHeightMm - margin * 2) * 96 / 25.4);
+    const pages = [];
+    let firstRow = 0;
+    let top = 0;
+    while (firstRow < rows.length) {
+        let lastRow = firstRow;
+        while (lastRow + 1 < rows.length && rows[lastRow + 1].offset + rows[lastRow + 1].size - top <= pageHeight)
+            lastRow++;
+        pages.push({ index: pages.length, top, height: pageHeight, firstRow, lastRow });
+        firstRow = lastRow + 1;
+        top = rows[firstRow]?.offset ?? rows.reduce((sum, row) => sum + row.size, 0);
+    }
+    return pages;
+}
+function freezePoint(value, rows, columns) {
+    const match = /^([A-Z]+)([1-9]\d*)$/.exec(value.toUpperCase());
+    if (!match?.[1] || !match[2])
+        return { x: 0, y: 0 };
+    const column = lettersToColumn(match[1]);
+    const row = Number(match[2]) - 1;
+    return {
+        x: columns[column]?.offset ?? columns.reduce((sum, track) => sum + track.size, 0),
+        y: rows[row]?.offset ?? rows.reduce((sum, track) => sum + track.size, 0)
+    };
+}
+function tracks(count, fallback, size, hidden) {
+    const result = [];
+    let offset = 0;
+    for (let index = 0; index < count; index++) {
+        const isHidden = hidden.has(index);
+        const current = isHidden ? 0 : clamp(number(size(index), fallback), 0, 2000);
+        result.push({ index, offset, size: current, hidden: isHidden });
+        offset += current;
+    }
+    return result;
+}
+function cellBounds(rows, columns, row, column, rowspan, colspan) {
+    return {
+        x: columns[column]?.offset ?? 0,
+        y: rows[row]?.offset ?? 0,
+        width: sumTrack(columns, column, colspan),
+        height: sumTrack(rows, row, rowspan)
+    };
+}
+function sumTrack(tracks, start, count) {
+    let result = 0;
+    for (let index = start; index < Math.min(tracks.length, start + count); index++)
+        result += tracks[index].size;
+    return result;
+}
+function normalizeStyle(source) {
+    const font = object(source.font);
+    const border = object(source.border);
+    return {
+        background: color(source.bgcolor ?? source.background, '#FFFFFF'),
+        color: color(source.color, '#111827'),
+        fontFamily: safeFont(font.name),
+        fontSize: clamp(number(font.size, 11), 6, 96),
+        fontWeight: font.bold === true ? 'bold' : 'normal',
+        fontStyle: font.italic === true ? 'italic' : 'normal',
+        textAlign: enumValue(source.align, ['left', 'center', 'right'], 'left'),
+        verticalAlign: enumValue(source.valign, ['top', 'middle', 'bottom'], 'middle'),
+        whiteSpace: source.textwrap === false ? 'nowrap' : 'pre-wrap',
+        borderTop: borderValue(border.top),
+        borderRight: borderValue(border.right),
+        borderBottom: borderValue(border.bottom),
+        borderLeft: borderValue(border.left)
+    };
+}
+function normalizePadding(value) {
+    if (Array.isArray(value)) {
+        const values = value.slice(0, 4).map(item => clamp(number(item, 4), 0, 100));
+        if (values.length === 2)
+            return [values[0], values[1], values[0], values[1]];
+        if (values.length === 4)
+            return values;
+    }
+    const padding = clamp(number(value, 4), 0, 100);
+    return [padding, padding, padding, padding];
+}
+function inset(bounds, padding) {
+    return {
+        x: bounds.x + padding[3],
+        y: bounds.y + padding[0],
+        width: Math.max(0, bounds.width - padding[1] - padding[3]),
+        height: Math.max(0, bounds.height - padding[0] - padding[2])
+    };
+}
+function borderValue(value) {
+    if (!Array.isArray(value) || value.length < 2)
+        return '1px solid #E5E7EB';
+    const width = string(value[0], 'thin') === 'thick' ? 3 : string(value[0], 'thin') === 'medium' ? 2 : 1;
+    return `${width}px solid ${color(value[1], '#9CA3AF')}`;
+}
+function parseA1Range(value) {
+    const match = /^([A-Z]+)([1-9]\d*):([A-Z]+)([1-9]\d*)$/i.exec(value);
+    if (!match?.[1] || !match[2] || !match[3] || !match[4])
+        return undefined;
+    return { row: Number(match[2]) - 1, column: lettersToColumn(match[1]), endRow: Number(match[4]) - 1, endColumn: lettersToColumn(match[3]) };
+}
+function lettersToColumn(value) {
+    let result = 0;
+    for (const character of value.toUpperCase())
+        result = result * 26 + character.charCodeAt(0) - 64;
+    return Math.max(0, result - 1);
+}
+function areaEnd(document, key) {
+    return clamp(integer(object(document.area)[key], 0), 0, MAX_TRACKS - 1);
+}
+function maxCellColumn(rows) {
+    let result = 0;
+    for (const row of rows)
+        for (const key of Object.keys(row.cells))
+            result = Math.max(result, integer(key, 0));
+    return result;
+}
+function arrays(...values) {
+    return values.flatMap(value => Array.isArray(value) ? value : []).slice(0, 100_000);
+}
+function parseObject(value) {
+    if (typeof value !== 'string')
+        return object(value);
+    try {
+        return object(JSON.parse(value));
+    }
+    catch {
+        return {};
+    }
+}
+function safeResource(value) {
+    const source = string(value, '').trim();
+    if (!source || source.startsWith('//') || source.includes('\\') || /[\u0000-\u001f]/.test(source))
+        return undefined;
+    if (source.startsWith('/') || /^[A-Za-z0-9_.-]+\//.test(source))
+        return source;
+    try {
+        const url = new URL(source);
+        return ['http:', 'https:'].includes(url.protocol) && !url.username && !url.password ? source : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function safeLink(value) {
+    const link = string(value, '').trim();
+    if (!link)
+        return undefined;
+    if (link.startsWith('/') && !link.startsWith('//') && !link.includes('\\'))
+        return link;
+    try {
+        const url = new URL(link);
+        return url.protocol === 'https:' && !url.username && !url.password ? link : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function safeIdentifier(value, fallback) {
+    const result = string(value, fallback);
+    return /^[A-Za-z0-9_.-]{1,128}$/.test(result) ? result : fallback;
+}
+function safeFont(value) {
+    const font = string(value, 'Microsoft YaHei');
+    return /^[\p{L}\p{N} _,-]{1,128}$/u.test(font) ? font : 'Microsoft YaHei';
+}
+function color(value, fallback) {
+    const candidate = string(value, fallback).trim();
+    return SAFE_COLOR.test(candidate) ? candidate : fallback;
+}
+function integerSet(value) {
+    return new Set((Array.isArray(value) ? value : []).map(item => integer(item, -1)).filter(item => item >= 0));
+}
+function object(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+function string(value, fallback) {
+    return typeof value === 'string' ? value : value == null ? fallback : String(value);
+}
+function number(value, fallback) {
+    const result = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(result) ? result : fallback;
+}
+function integer(value, fallback) {
+    return Math.trunc(number(value, fallback));
+}
+function clamp(value, minimum, maximum) {
+    return Math.min(maximum, Math.max(minimum, value));
+}
+function enumValue(value, values, fallback) {
+    return values.includes(value) ? value : fallback;
+}
+function deepFreeze(value) {
+    if (value && typeof value === 'object' && !Object.isFrozen(value)) {
+        Object.freeze(value);
+        for (const child of Object.values(value))
+            deepFreeze(child);
+    }
+    return value;
+}

package/dist/types.d.ts

@@ -0,0 +1,132 @@
+export interface NativeBounds {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface NativeAxisTrack {
+    readonly index: number;
+    readonly offset: number;
+    readonly size: number;
+    readonly hidden: boolean;
+}
+export interface NativeCellStyle {
+    readonly background: string;
+    readonly color: string;
+    readonly fontFamily: string;
+    readonly fontSize: number;
+    readonly fontWeight: 'normal' | 'bold';
+    readonly fontStyle: 'normal' | 'italic';
+    readonly textAlign: 'left' | 'center' | 'right';
+    readonly verticalAlign: 'top' | 'middle' | 'bottom';
+    readonly whiteSpace: 'normal' | 'pre-wrap' | 'nowrap';
+    readonly borderTop: string;
+    readonly borderRight: string;
+    readonly borderBottom: string;
+    readonly borderLeft: string;
+}
+export type NativeRichTextStyle = Readonly<Record<string, string>>;
+export type NativeRichTextNode = {
+    readonly type: 'text';
+    readonly text: string;
+} | {
+    readonly type: 'lineBreak';
+} | {
+    readonly type: 'div' | 'paragraph' | 'span' | 'strong' | 'emphasis';
+    readonly children: readonly NativeRichTextNode[];
+    readonly style?: NativeRichTextStyle;
+};
+export interface NativeCell {
+    readonly id: string;
+    readonly row: number;
+    readonly column: number;
+    readonly rowspan: number;
+    readonly colspan: number;
+    readonly bounds: NativeBounds;
+    readonly contentBox: NativeBounds;
+    readonly zIndex: number;
+    readonly text: string;
+    readonly richText?: readonly NativeRichTextNode[];
+    readonly hyperlink?: string;
+    readonly style: NativeCellStyle;
+}
+export interface NativeLayerBase {
+    readonly id: string;
+    readonly bounds: NativeBounds;
+    readonly contentBox: NativeBounds;
+    readonly zIndex: number;
+}
+export type NativeChartType = 'bar' | 'line' | 'pie' | 'scatter' | 'funnel' | 'radar' | 'gauge' | 'pictorialBar';
+export type NativeLayer = (NativeLayerBase & {
+    readonly type: 'image';
+    readonly source: string;
+    readonly alt: string;
+}) | (NativeLayerBase & {
+    readonly type: 'chart';
+    readonly chartType: NativeChartType;
+    readonly title: string;
+    readonly categories: readonly string[];
+    readonly values: readonly number[];
+}) | (NativeLayerBase & {
+    readonly type: 'map';
+    readonly title: string;
+    readonly points: readonly {
+        readonly name: string;
+        readonly value: number;
+    }[];
+}) | (NativeLayerBase & {
+    readonly type: 'barcode';
+    readonly text: string;
+    readonly label: string;
+    readonly color: string;
+    readonly background: string;
+    readonly displayValue: boolean;
+    readonly fontSize: number;
+}) | (NativeLayerBase & {
+    readonly type: 'qrcode';
+    readonly text: string;
+    readonly color: string;
+    readonly background: string;
+}) | (NativeLayerBase & {
+    readonly type: 'richText';
+    readonly nodes: readonly NativeRichTextNode[];
+});
+export interface NativePage {
+    readonly index: number;
+    readonly top: number;
+    readonly height: number;
+    readonly firstRow: number;
+    readonly lastRow: number;
+}
+export interface NativeViewerSheet {
+    readonly id: string;
+    readonly name: string;
+    readonly order: number;
+    readonly width: number;
+    readonly height: number;
+    readonly rows: readonly NativeAxisTrack[];
+    readonly columns: readonly NativeAxisTrack[];
+    readonly cells: readonly NativeCell[];
+    readonly layers: readonly NativeLayer[];
+    readonly pages: readonly NativePage[];
+    readonly frozen: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+export interface NativeViewerDocument {
+    readonly schemaVersion: 'native-v1';
+    readonly reportId: string;
+    readonly revision: string;
+    readonly title: string;
+    readonly activeSheetId: string;
+    readonly sheets: readonly NativeViewerSheet[];
+}
+export type NativeDatasetRow = Readonly<Record<string, string | boolean | null>>;
+export type NativeDatasetValues = Readonly<Record<string, readonly NativeDatasetRow[]>>;
+export interface NativeConversionOptions {
+    readonly datasets?: NativeDatasetValues;
+    readonly defaultRowHeight?: number;
+    readonly defaultColumnWidth?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "@qianxiang-ai/fu-report-viewer-engine",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.1.7",
+  "license": "AGPL-3.0-only",
+  "author": "位志国 <ijunfu@aliyun.com>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@qianxiang-ai/fu-report-contracts": "1.1.7"
+  },
+  "scripts": {
+    "build": "node ../../scripts/clean-dist.mjs && tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run src"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.