@file-viewer/renderer-eda 2.1.2 → 2.1.4

package/dist/eda.d.ts

@@ -1,2 +1,2 @@
-import type { FileRenderContext, FileViewerRenderedInstance } from '@file-viewer/core';
+import { type FileRenderContext, type FileViewerRenderedInstance } from '@file-viewer/core';
 export default function renderEda(buffer: ArrayBuffer, target: HTMLDivElement, type?: string, context?: FileRenderContext): Promise<FileViewerRenderedInstance>;

package/dist/eda.js

@@ -1,22 +1,131 @@
+import { resolveFileViewerLocale, } from '@file-viewer/core';
 import { createEdaLayoutWebglBatch, } from '@file-viewer/eda-layout';
 import { parseEdaFile, } from './edaParser';
-const roleLabels = {
-    root: '根',
-    library: '库',
-    symbol: '元件符号',
-    footprint: '封装',
-    padstack: 'Padstack',
-    drawing: '图纸',
-    metadata: '元数据',
-    property: '属性',
-    geometry: '几何',
-    net: '网络',
-    unknown: '未知',
+const EDA_UI_TEXT = {
+    'zh-CN': {
+        'role.root': '根',
+        'role.library': '库',
+        'role.symbol': '元件符号',
+        'role.footprint': '封装',
+        'role.padstack': 'Padstack',
+        'role.drawing': '图纸',
+        'role.metadata': '元数据',
+        'role.property': '属性',
+        'role.geometry': '几何',
+        'role.net': '网络',
+        'role.unknown': '未知',
+        'confidence.high': '高',
+        'confidence.medium': '中',
+        'confidence.low': '低',
+        'kind.storage': '目录',
+        'kind.text': '文本',
+        'kind.binary': '二进制',
+        'panel.layout': '版图预览',
+        'empty.noGeometry.title': '没有可绘制几何',
+        'empty.noGeometry.description': '已读取 {layout} 头部和 structure 信息，但未发现 boundary、path、text 或 reference 元素。',
+        'stats.textStreams': '文本流',
+        'stats.binaryStreams': '二进制流',
+        'stats.storageEntries': '目录',
+        'stats.properties': '属性',
+        'stats.symbols': '符号',
+        'stats.footprints': '封装',
+        'stats.confidence': '可信度',
+        'group.symbol': '元件符号',
+        'group.footprint': '封装图形',
+        'group.drawing': '图纸信息',
+        'state.loading': '正在解析 {type}...',
+        'state.errorTitle': 'EDA 预览提示',
+        'header.format': '格式',
+        'header.size': '大小',
+        'header.entries': '条目',
+        'summary.layoutReady': '{layout} 属于芯片版图工程文件。预览器已在浏览器端解析可识别几何，小图生成 SVG，大图自动切换 WebGL canvas，同时保留结构、字符串和诊断索引。',
+        'summary.layoutSafe': 'GDSII / OASIS 属于芯片版图工程文件。预览器优先索引结构、属性、可读字符串和二进制线索，并在纯前端安全退化。',
+        'summary.orcadSafe': 'OLB / DRA 属于 OrCAD / Allegro 生态的私有设计数据。预览器优先解析 CFB 结构、对象候选、属性和可读文本，并在纯前端安全退化。',
+        'search.placeholder': '筛选路径、角色、属性或文本',
+        'selection.title': '当前条目',
+        'selection.none': '未选择',
+        'selection.storageTitle': '目录条目',
+        'selection.storageDescription': '该节点用于组织下级流，没有可直接展示的文本或十六进制片段。',
+        'selection.localStrings': '当前条目字符串',
+        'panel.overview': '解析概览',
+        'panel.tree': '结构树',
+        'panel.objects': 'EDA 对象',
+        'panel.strings': '可读字符串',
+        'panel.diagnostics': '诊断',
+        'panel.nodeCount': '{count} 节点',
+        'panel.itemCount': '{count} 项',
+        'panel.entryCount': '{count} 条目',
+        'empty.noObjects.title': '没有明确对象候选',
+        'empty.noObjects.description': '仍可从结构树、属性和字符串索引中查看可读内容。',
+        'meta.renderer': '渲染器',
+        'meta.library': '库',
+        'meta.userUnit': '用户单位',
+        'meta.dbUnit': '数据库单位',
+    },
+    'en-US': {
+        'role.root': 'Root',
+        'role.library': 'Library',
+        'role.symbol': 'Symbol',
+        'role.footprint': 'Footprint',
+        'role.padstack': 'Padstack',
+        'role.drawing': 'Drawing',
+        'role.metadata': 'Metadata',
+        'role.property': 'Property',
+        'role.geometry': 'Geometry',
+        'role.net': 'Net',
+        'role.unknown': 'Unknown',
+        'confidence.high': 'High',
+        'confidence.medium': 'Medium',
+        'confidence.low': 'Low',
+        'kind.storage': 'Directory',
+        'kind.text': 'Text',
+        'kind.binary': 'Binary',
+        'panel.layout': 'Layout preview',
+        'empty.noGeometry.title': 'No drawable geometry',
+        'empty.noGeometry.description': '{layout} headers and structure metadata were read, but no boundary, path, text, or reference elements were found.',
+        'stats.textStreams': 'Text streams',
+        'stats.binaryStreams': 'Binary streams',
+        'stats.storageEntries': 'Directories',
+        'stats.properties': 'Properties',
+        'stats.symbols': 'Symbols',
+        'stats.footprints': 'Footprints',
+        'stats.confidence': 'Confidence',
+        'group.symbol': 'Component symbols',
+        'group.footprint': 'Footprint graphics',
+        'group.drawing': 'Drawing information',
+        'state.loading': 'Parsing {type}...',
+        'state.errorTitle': 'EDA preview notice',
+        'header.format': 'Format',
+        'header.size': 'Size',
+        'header.entries': 'Entries',
+        'summary.layoutReady': '{layout} is an IC layout engineering file. Recognizable geometry is parsed in the browser, small drawings use SVG, large drawings switch to WebGL canvas, and structure, strings, and diagnostics remain indexed.',
+        'summary.layoutSafe': 'GDSII / OASIS are IC layout engineering files. The viewer prioritizes structure, properties, readable strings, and binary clues, then degrades safely in the frontend.',
+        'summary.orcadSafe': 'OLB / DRA are private OrCAD / Allegro design assets. The viewer prioritizes CFB structure, object candidates, properties, and readable text with safe frontend degradation.',
+        'search.placeholder': 'Filter paths, roles, properties, or text',
+        'selection.title': 'Current entry',
+        'selection.none': 'Not selected',
+        'selection.storageTitle': 'Directory entry',
+        'selection.storageDescription': 'This node organizes child streams and has no directly displayable text or hex fragment.',
+        'selection.localStrings': 'Current entry strings',
+        'panel.overview': 'Parse overview',
+        'panel.tree': 'Structure tree',
+        'panel.objects': 'EDA objects',
+        'panel.strings': 'Readable strings',
+        'panel.diagnostics': 'Diagnostics',
+        'panel.nodeCount': '{count} nodes',
+        'panel.itemCount': '{count} items',
+        'panel.entryCount': '{count} entries',
+        'empty.noObjects.title': 'No clear object candidates',
+        'empty.noObjects.description': 'Readable content is still available from the structure tree, properties, and string index.',
+        'meta.renderer': 'Renderer',
+        'meta.library': 'Library',
+        'meta.userUnit': 'User unit',
+        'meta.dbUnit': 'DB unit',
+    },
 };
-const confidenceLabels = {
-    high: '高',
-    medium: '中',
-    low: '低',
+const formatEdaUiText = (locale, key, params = {}) => {
+    const template = EDA_UI_TEXT[locale][key] || EDA_UI_TEXT['zh-CN'][key] || key;
+    return Object.entries(params).reduce((message, [name, value]) => message.replace(new RegExp(`\\{${name}\\}`, 'g'), String(value)), template);
 };
 const edaStyle = `
 .eda-viewer{position:relative;height:100%;min-height:0;display:flex;flex-direction:column;background:#edf1f5;color:#172033;box-sizing:border-box}
@@ -122,9 +231,12 @@ const formatBytes = (value) => {
     }
     return `${(value / 1024).toFixed(value < 10 * 1024 ? 1 : 0)} KB`;
 };
-const roleLabel = (role) => roleLabels[role] || role;
-const kindLabel = (kind) => {
-    return kind === 'storage' ? '目录' : kind === 'text' ? '文本' : '二进制';
+const roleLabel = (role, locale) => {
+    return formatEdaUiText(locale, `role.${role}`) || role;
+};
+const confidenceLabel = (confidence, locale) => formatEdaUiText(locale, `confidence.${confidence}`);
+const kindLabel = (kind, locale) => {
+    return formatEdaUiText(locale, `kind.${kind}`);
 };
 const normalizePath = (value) => value.replace(/^\/+/, '').toLowerCase();
 const flattenTree = (nodes, depth = 0) => {
@@ -328,19 +440,19 @@ const createWebglLayoutPreview = (layout, width, height) => {
         batch,
     };
 };
-const createLayoutPreview = (layout) => {
+const createLayoutPreview = (layout, locale) => {
     const panel = createElement('section', 'eda-panel eda-layout-panel');
     const layoutLabel = layout.format === 'oasis' ? 'OASIS' : 'GDSII';
-    appendPanelHead(panel, '版图预览', `${layoutLabel} · ${layout.structureCount || layout.structures.length} structures · ${layout.elements.length} elements`);
+    appendPanelHead(panel, formatEdaUiText(locale, 'panel.layout'), `${layoutLabel} · ${layout.structureCount || layout.structures.length} structures · ${layout.elements.length} elements`);
     const meta = createElement('div', 'eda-layout-meta');
     [
-        `Library: ${layout.libraryName || '-'}`,
-        `User unit: ${formatOptionalNumber(layout.userUnit)}`,
-        `DB unit: ${formatOptionalNumber(layout.databaseUnit)}`,
+        `${formatEdaUiText(locale, 'meta.library')}: ${layout.libraryName || '-'}`,
+        `${formatEdaUiText(locale, 'meta.userUnit')}: ${formatOptionalNumber(layout.userUnit)}`,
+        `${formatEdaUiText(locale, 'meta.dbUnit')}: ${formatOptionalNumber(layout.databaseUnit)}`,
     ].forEach(item => meta.append(createElement('span', undefined, item)));
     panel.append(meta);
     if (!layout.bounds || !layout.elements.length) {
-        panel.append(createEmpty('没有可绘制几何', `已读取 ${layoutLabel} 头部和 structure 信息，但未发现 boundary、path、text 或 reference 元素。`));
+        panel.append(createEmpty(formatEdaUiText(locale, 'empty.noGeometry.title'), formatEdaUiText(locale, 'empty.noGeometry.description', { layout: layoutLabel })));
         return panel;
     }
     const bounds = layout.bounds;
@@ -367,7 +479,7 @@ const createLayoutPreview = (layout) => {
         ? createWebglLayoutPreview(layout, svgWidth, svgHeight)
         : null;
     if (webglPreview) {
-        meta.append(createElement('span', undefined, `Renderer: WebGL · ${webglPreview.batch.elementCount} elements`));
+        meta.append(createElement('span', undefined, `${formatEdaUiText(locale, 'meta.renderer')}: WebGL · ${webglPreview.batch.elementCount} elements`));
         webglPreview.batch.warnings.forEach(item => {
             const warning = createElement('div', 'eda-warning');
             warning.append(createElement('p', undefined, item));
@@ -377,7 +489,7 @@ const createLayoutPreview = (layout) => {
         panel.append(canvas);
         return panel;
     }
-    meta.append(createElement('span', undefined, 'Renderer: SVG'));
+    meta.append(createElement('span', undefined, `${formatEdaUiText(locale, 'meta.renderer')}: SVG`));
     const svg = createSvgElement('svg', {
         class: 'eda-layout-svg',
         width: svgWidth,
@@ -439,25 +551,25 @@ const createLayoutPreview = (layout) => {
     panel.append(canvas);
     return panel;
 };
-const buildStatsCards = (parsed) => {
+const buildStatsCards = (parsed, locale) => {
     const stats = parsed.stats;
     return [
-        { label: '文本流', value: stats.textStreams },
-        { label: '二进制流', value: stats.binaryStreams },
-        { label: '目录', value: stats.storageEntries },
-        { label: '属性', value: stats.propertyCount },
-        { label: '符号', value: stats.symbolCount },
-        { label: '封装', value: stats.footprintCount },
+        { label: formatEdaUiText(locale, 'stats.textStreams'), value: stats.textStreams },
+        { label: formatEdaUiText(locale, 'stats.binaryStreams'), value: stats.binaryStreams },
+        { label: formatEdaUiText(locale, 'stats.storageEntries'), value: stats.storageEntries },
+        { label: formatEdaUiText(locale, 'stats.properties'), value: stats.propertyCount },
+        { label: formatEdaUiText(locale, 'stats.symbols'), value: stats.symbolCount },
+        { label: formatEdaUiText(locale, 'stats.footprints'), value: stats.footprintCount },
         { label: 'Padstack', value: stats.padstackCount },
-        { label: '可信度', value: confidenceLabels[stats.confidence] },
+        { label: formatEdaUiText(locale, 'stats.confidence'), value: confidenceLabel(stats.confidence, locale) },
     ];
 };
-const buildEntityGroups = (entities) => {
+const buildEntityGroups = (entities, locale) => {
     const groups = [
-        { role: 'symbol', label: '元件符号', items: [] },
-        { role: 'footprint', label: '封装图形', items: [] },
+        { role: 'symbol', label: formatEdaUiText(locale, 'group.symbol'), items: [] },
+        { role: 'footprint', label: formatEdaUiText(locale, 'group.footprint'), items: [] },
         { role: 'padstack', label: 'Padstack', items: [] },
-        { role: 'drawing', label: '图纸信息', items: [] },
+        { role: 'drawing', label: formatEdaUiText(locale, 'group.drawing'), items: [] },
     ];
     groups.forEach(group => {
         group.items = entities.filter(entity => entity.role === group.role);
@@ -480,6 +592,7 @@ const createEmpty = (title, description) => {
 };
 export default async function renderEda(buffer, target, type = 'olb', context) {
     const normalizedType = ['dra', 'gds', 'oas', 'oasis'].includes(type) ? type : 'olb';
+    const locale = resolveFileViewerLocale(context?.options) === 'en-US' ? 'en-US' : 'zh-CN';
     const filename = context?.filename || `preview.${normalizedType}`;
     const root = createElement('section', 'eda-viewer');
     const style = createStyle();
@@ -493,13 +606,13 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
     };
     const showLoading = () => {
         const state = createElement('div', 'eda-state');
-        state.append(createElement('span'), createElement('strong', undefined, `正在解析 ${normalizedType.toUpperCase()}...`));
+        state.append(createElement('span'), createElement('strong', undefined, formatEdaUiText(locale, 'state.loading', { type: normalizedType.toUpperCase() })));
         root.append(state);
         return state;
     };
     const showError = (message) => {
         const error = createElement('div', 'eda-error');
-        error.append(createElement('strong', undefined, 'EDA 预览提示'), createElement('p', undefined, message));
+        error.append(createElement('strong', undefined, formatEdaUiText(locale, 'state.errorTitle')), createElement('p', undefined, message));
         root.append(error);
     };
     const renderParsed = (parsed) => {
@@ -508,27 +621,27 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
             || parsed.streams.find(stream => stream.kind === 'text')
             || parsed.streams[0]
             || null;
-        const statsCards = buildStatsCards(parsed);
+        const statsCards = buildStatsCards(parsed, locale);
         const treeRows = flattenTree(parsed.tree);
-        const entityGroups = buildEntityGroups(parsed.entities);
+        const entityGroups = buildEntityGroups(parsed.entities, locale);
         root.replaceChildren();
         const header = createElement('header', 'eda-header');
         const headerTitle = document.createElement('div');
         headerTitle.append(createElement('span', undefined, parsed.parser === 'cfb' ? 'CFB STRUCTURE VIEWER' : 'BINARY STRUCTURE VIEWER'), createElement('h2', undefined, filename));
         const headerStats = document.createElement('dl');
-        appendDefinition(headerStats, '格式', parsed.type.toUpperCase());
-        appendDefinition(headerStats, '大小', formatBytes(parsed.byteLength));
-        appendDefinition(headerStats, '条目', String(parsed.streamCount));
-        appendDefinition(headerStats, '可信度', confidenceLabels[parsed.stats.confidence]);
+        appendDefinition(headerStats, formatEdaUiText(locale, 'header.format'), parsed.type.toUpperCase());
+        appendDefinition(headerStats, formatEdaUiText(locale, 'header.size'), formatBytes(parsed.byteLength));
+        appendDefinition(headerStats, formatEdaUiText(locale, 'header.entries'), String(parsed.streamCount));
+        appendDefinition(headerStats, formatEdaUiText(locale, 'stats.confidence'), confidenceLabel(parsed.stats.confidence, locale));
         header.append(headerTitle, headerStats);
         const body = createElement('div', 'eda-body');
         const sidebar = createElement('aside', 'eda-sidebar');
         const summary = createElement('div', 'eda-summary');
         summary.append(createElement('strong', undefined, parsed.title), createElement('p', undefined, parsed.type === 'gds' || parsed.type === 'oas' || parsed.type === 'oasis'
             ? parsed.layout
-                ? `${parsed.layout.format === 'oasis' ? 'OASIS' : 'GDSII'} 属于芯片版图工程文件。预览器已在浏览器端解析可识别几何，小图生成 SVG，大图自动切换 WebGL canvas，同时保留结构、字符串和诊断索引。`
-                : 'GDSII / OASIS 属于芯片版图工程文件。预览器优先索引结构、属性、可读字符串和二进制线索，并在纯前端安全退化。'
-            : 'OLB / DRA 属于 OrCAD / Allegro 生态的私有设计数据。预览器优先解析 CFB 结构、对象候选、属性和可读文本，并在纯前端安全退化。'));
+                ? formatEdaUiText(locale, 'summary.layoutReady', { layout: parsed.layout.format === 'oasis' ? 'OASIS' : 'GDSII' })
+                : formatEdaUiText(locale, 'summary.layoutSafe')
+            : formatEdaUiText(locale, 'summary.orcadSafe')));
         sidebar.append(summary);
         appendStatGrid(sidebar, statsCards.slice(0, 4), 'eda-mini-grid');
         if (parsed.warnings.length) {
@@ -538,15 +651,15 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
         }
         const search = createElement('input', 'eda-search');
         search.type = 'search';
-        search.placeholder = '筛选路径、角色、属性或文本';
+        search.placeholder = formatEdaUiText(locale, 'search.placeholder');
         sidebar.append(search);
         const streamList = createElement('div', 'eda-stream-list');
         const preview = createElement('main', 'eda-preview');
         let streamButtons = [];
         const currentPanel = createElement('section', 'eda-panel');
         const selectedHead = createElement('div', 'eda-panel-head');
-        const selectedTitle = createElement('span', undefined, '当前条目');
-        const selectedPath = createElement('strong', undefined, '未选择');
+        const selectedTitle = createElement('span', undefined, formatEdaUiText(locale, 'selection.title'));
+        const selectedPath = createElement('strong', undefined, formatEdaUiText(locale, 'selection.none'));
         selectedHead.append(selectedTitle, selectedPath);
         const selectedMeta = createElement('div', 'eda-selected-meta');
         const selectedProperties = createElement('div', 'eda-property-grid');
@@ -557,16 +670,16 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
             streamButtons.forEach(({ path, button }) => {
                 button.classList.toggle('active', normalizePath(path) === normalizePath(selectedStream?.path || ''));
             });
-            selectedPath.textContent = selectedStream?.path || '未选择';
+            selectedPath.textContent = selectedStream?.path || formatEdaUiText(locale, 'selection.none');
             selectedMeta.replaceChildren();
             selectedProperties.replaceChildren();
             selectedPreviewContainer.replaceChildren();
             localStrings.replaceChildren();
             if (!selectedStream) {
-                selectedPreviewContainer.append(createEmpty('目录条目', '该节点用于组织下级流，没有可直接展示的文本或十六进制片段。'));
+                selectedPreviewContainer.append(createEmpty(formatEdaUiText(locale, 'selection.storageTitle'), formatEdaUiText(locale, 'selection.storageDescription')));
                 return;
             }
-            selectedMeta.append(createElement('span', undefined, roleLabel(selectedStream.role)), createElement('span', undefined, kindLabel(selectedStream.kind)), createElement('span', undefined, formatBytes(selectedStream.size)));
+            selectedMeta.append(createElement('span', undefined, roleLabel(selectedStream.role, locale)), createElement('span', undefined, kindLabel(selectedStream.kind, locale)), createElement('span', undefined, formatBytes(selectedStream.size)));
             selectedStream.properties.forEach(property => {
                 const item = document.createElement('div');
                 item.append(createElement('span', undefined, property.key), createElement('strong', undefined, property.value));
@@ -577,10 +690,10 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
                 selectedPreviewContainer.append(createElement('pre', undefined, previewText));
             }
             else {
-                selectedPreviewContainer.append(createEmpty('目录条目', '该节点用于组织下级流，没有可直接展示的文本或十六进制片段。'));
+                selectedPreviewContainer.append(createEmpty(formatEdaUiText(locale, 'selection.storageTitle'), formatEdaUiText(locale, 'selection.storageDescription')));
             }
             if (selectedStream.strings.length) {
-                localStrings.append(createElement('strong', undefined, '当前条目字符串'));
+                localStrings.append(createElement('strong', undefined, formatEdaUiText(locale, 'selection.localStrings')));
                 selectedStream.strings.forEach(item => localStrings.append(createElement('span', undefined, item)));
             }
         };
@@ -620,9 +733,9 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
             parsed.streams.filter(stream => matchesFilter(stream, keyword)).forEach(stream => {
                 const button = createElement('button', 'eda-stream');
                 button.type = 'button';
-                const role = createElement('span', undefined, roleLabel(stream.role));
+                const role = createElement('span', undefined, roleLabel(stream.role, locale));
                 role.dataset.role = stream.role;
-                button.append(role, createElement('strong', undefined, stream.name || stream.path), createElement('em', undefined, stream.path), createElement('small', undefined, `${kindLabel(stream.kind)} · ${formatBytes(stream.size)}`));
+                button.append(role, createElement('strong', undefined, stream.name || stream.path), createElement('em', undefined, stream.path), createElement('small', undefined, `${kindLabel(stream.kind, locale)} · ${formatBytes(stream.size)}`));
                 listen(button, 'click', () => selectStream(stream));
                 streamButtons.push({ path: stream.path, button });
                 streamList.append(button);
@@ -632,24 +745,24 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
         listen(search, 'input', renderStreams);
         sidebar.append(streamList);
         const overview = createElement('section', 'eda-panel eda-panel--compact');
-        appendPanelHead(overview, '解析概览', `${parsed.parser.toUpperCase()} · ${formatBytes(parsed.totalStreamBytes)}`);
+        appendPanelHead(overview, formatEdaUiText(locale, 'panel.overview'), `${parsed.parser.toUpperCase()} · ${formatBytes(parsed.totalStreamBytes)}`);
         appendStatGrid(overview, statsCards, 'eda-stat-grid');
         const topology = createElement('section', 'eda-topology');
         const treePanel = createElement('div', 'eda-panel');
-        appendPanelHead(treePanel, '结构树', `${treeRows.length} 节点`);
+        appendPanelHead(treePanel, formatEdaUiText(locale, 'panel.tree'), formatEdaUiText(locale, 'panel.nodeCount', { count: treeRows.length }));
         const tree = createElement('div', 'eda-tree');
         treeRows.forEach(row => {
             const button = createElement('button');
             button.type = 'button';
             const twist = createElement('span', undefined, row.children.length ? '▸' : '•');
             twist.style.paddingLeft = `${row.depth * 14}px`;
-            button.append(twist, createElement('strong', undefined, row.name), createElement('em', undefined, roleLabel(row.role)), createElement('small', undefined, row.size ? formatBytes(row.size) : kindLabel(row.kind)));
+            button.append(twist, createElement('strong', undefined, row.name), createElement('em', undefined, roleLabel(row.role, locale)), createElement('small', undefined, row.size ? formatBytes(row.size) : kindLabel(row.kind, locale)));
             listen(button, 'click', () => selectTreeRow(row));
             tree.append(button);
         });
         treePanel.append(tree);
         const entityPanel = createElement('div', 'eda-panel');
-        appendPanelHead(entityPanel, 'EDA 对象', `${parsed.entities.length} 项`);
+        appendPanelHead(entityPanel, formatEdaUiText(locale, 'panel.objects'), formatEdaUiText(locale, 'panel.itemCount', { count: parsed.entities.length }));
         if (entityGroups.length) {
             const entityRoot = createElement('div', 'eda-entities');
             entityGroups.forEach(group => {
@@ -658,7 +771,7 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
                 group.items.forEach(entity => {
                     const button = createElement('button');
                     button.type = 'button';
-                    button.append(createElement('strong', undefined, entity.name), createElement('span', undefined, `${formatBytes(entity.byteLength)} · ${entity.streamCount} 条目`));
+                    button.append(createElement('strong', undefined, entity.name), createElement('span', undefined, `${formatBytes(entity.byteLength)} · ${formatEdaUiText(locale, 'panel.entryCount', { count: entity.streamCount })}`));
                     if (entity.description) {
                         button.append(createElement('p', undefined, entity.description));
                     }
@@ -683,17 +796,17 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
             entityPanel.append(entityRoot);
         }
         else {
-            entityPanel.append(createEmpty('没有明确对象候选', '仍可从结构树、属性和字符串索引中查看可读内容。'));
+            entityPanel.append(createEmpty(formatEdaUiText(locale, 'empty.noObjects.title'), formatEdaUiText(locale, 'empty.noObjects.description')));
         }
         topology.append(treePanel, entityPanel);
         const bottom = createElement('section', 'eda-bottom');
         const stringsPanel = createElement('div', 'eda-panel');
-        appendPanelHead(stringsPanel, '可读字符串', `${parsed.strings.length} 项`);
+        appendPanelHead(stringsPanel, formatEdaUiText(locale, 'panel.strings'), formatEdaUiText(locale, 'panel.itemCount', { count: parsed.strings.length }));
         const stringGrid = createElement('div', 'eda-string-grid');
         parsed.strings.forEach(item => stringGrid.append(createElement('span', undefined, item)));
         stringsPanel.append(stringGrid);
         const diagnosticsPanel = createElement('div', 'eda-panel');
-        appendPanelHead(diagnosticsPanel, '诊断', `${parsed.diagnostics.length} 条`);
+        appendPanelHead(diagnosticsPanel, formatEdaUiText(locale, 'panel.diagnostics'), formatEdaUiText(locale, 'panel.itemCount', { count: parsed.diagnostics.length }));
         const diagnostics = createElement('div', 'eda-diagnostics');
         parsed.diagnostics.forEach(diagnostic => {
             const item = createElement('p');
@@ -704,7 +817,7 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
         diagnosticsPanel.append(diagnostics, localStrings);
         bottom.append(stringsPanel, diagnosticsPanel);
         if (parsed.layout) {
-            preview.append(createLayoutPreview(parsed.layout));
+            preview.append(createLayoutPreview(parsed.layout, locale));
         }
         preview.append(overview, topology, currentPanel, bottom);
         body.append(sidebar, preview);
@@ -713,7 +826,7 @@ export default async function renderEda(buffer, target, type = 'olb', context) {
     };
     const loading = showLoading();
     try {
-        const parsed = await parseEdaFile(buffer, normalizedType);
+        const parsed = await parseEdaFile(buffer, normalizedType, { locale });
         renderParsed(parsed);
     }
     catch (nextError) {

package/dist/edaParser.d.ts

@@ -1,4 +1,5 @@
 import { type EdaLayoutPreview } from '@file-viewer/eda-layout';
+export type EdaParserLocale = 'zh-CN' | 'en-US';
 export type { EdaLayoutElement, EdaLayoutPreview, } from '@file-viewer/eda-layout';
 export type EdaFileType = 'olb' | 'dra' | 'gds' | 'oas' | 'oasis';
 export type EdaParserMode = 'cfb' | 'binary';
@@ -77,4 +78,6 @@ export interface EdaParseResult {
     stats: EdaStats;
     layout?: EdaLayoutPreview;
 }
-export declare const parseEdaFile: (buffer: ArrayBuffer, type?: string) => Promise<EdaParseResult>;
+export declare const parseEdaFile: (buffer: ArrayBuffer, type?: string, options?: {
+    locale?: EdaParserLocale;
+}) => Promise<EdaParseResult>;

package/dist/edaParser.js

@@ -3,6 +3,40 @@ import { cleanupOrcadText as cleanupText, collectOrcadStrings as collectStrings,
 const MAX_STREAMS = 200;
 const MAX_STREAM_STRINGS = 24;
 const MAX_PROPERTIES = 420;
+const EDA_PARSER_TEXT = {
+    'zh-CN': {
+        oasisFixture: '已识别为 OASIS 文本结构夹具，并在浏览器端解析几何预览和结构索引；真实 SEMI 二进制 OASIS 仍走安全索引与后续独立内核路线。',
+        gdsLayout: '已识别为标准 GDSII 二进制版图记录，并在浏览器端解析几何预览和结构索引。',
+        cfbContainer: '已识别为 Microsoft Compound File / OLE2 复合文档容器，并在浏览器端解析目录与流。',
+        binaryIndex: '未识别为 CFB 容器，已使用二进制字符串索引模式展示可读信息。',
+        coverage: '已索引 {streams} 个条目、{strings} 个可读字符串、{entities} 个 EDA 结构候选。',
+        layout: '已解析 {layout}: {structures} 个 structure、{elements} 个几何/引用/文本元素，可在版图预览面板中拖动查看。',
+        noSymbol: '未发现明确的元件符号候选，文件可能使用了私有二进制编码或需要专业工具导出 ASCII/XML 后再检查。',
+        noFootprint: '未发现明确的封装、图形或 padstack 候选，文件可能使用了私有二进制数据库编码。',
+        noGds: '未发现明确的 GDSII 版图结构候选。文件可能不是标准 GDSII 二进制或使用了专有封装。',
+        noOasis: '未发现明确的 OASIS 版图结构候选。OASIS 完整几何浏览通常需要专业版图库或独立 WASM/TS 内核，当前前端包会安全展示头部、字符串、属性和二进制结构线索。',
+        maxStreams: '仅展示前 {count} 个 CFB 项，完整文件仍可下载后在专业 EDA 工具中打开。',
+        binaryFallback: '该文件不是标准 CFB 容器，已退化为安全的二进制字符串索引预览。',
+    },
+    'en-US': {
+        oasisFixture: 'Detected an OASIS text fixture and parsed geometry preview plus structure indexes in the browser. Full SEMI binary OASIS still follows the safe index and dedicated-kernel path.',
+        gdsLayout: 'Detected standard GDSII binary layout records and parsed geometry preview plus structure indexes in the browser.',
+        cfbContainer: 'Detected a Microsoft Compound File / OLE2 container and parsed its directory and streams in the browser.',
+        binaryIndex: 'This file is not recognized as a CFB container, so readable information is shown through a safe binary string index.',
+        coverage: 'Indexed {streams} entries, {strings} readable strings, and {entities} EDA structure candidates.',
+        layout: 'Parsed {layout}: {structures} structures and {elements} geometry/reference/text elements. Drag the layout preview panel to inspect it.',
+        noSymbol: 'No clear component-symbol candidates were found. The file may use private binary encoding or need ASCII/XML export from a professional tool.',
+        noFootprint: 'No clear footprint, drawing, or padstack candidates were found. The file may use private binary database encoding.',
+        noGds: 'No clear GDSII layout structure candidates were found. The file may not be standard GDSII binary or may use a proprietary wrapper.',
+        noOasis: 'No clear OASIS layout structure candidates were found. Full OASIS geometry browsing usually needs a professional layout library or dedicated WASM/TS kernel; this frontend package safely exposes headers, strings, properties, and binary clues.',
+        maxStreams: 'Only the first {count} CFB entries are shown. Download the full file and open it in a professional EDA tool for complete inspection.',
+        binaryFallback: 'This file is not a standard CFB container, so it falls back to a safe binary string index preview.',
+    },
+};
+const getEdaParserText = (locale, key, params = {}) => {
+    const template = EDA_PARSER_TEXT[locale]?.[key] || EDA_PARSER_TEXT['zh-CN'][key] || key;
+    return Object.entries(params).reduce((message, [name, value]) => message.replace(new RegExp(`\\{${name}\\}`, 'g'), String(value)), template);
+};
 const toBytes = (buffer) => new Uint8Array(buffer);
 const normalizeBytes = (value) => {
     return value instanceof Uint8Array ? value : new Uint8Array(value);
@@ -352,7 +386,7 @@ const buildStats = (streams, entities, strings, parser, layout) => {
     }
     return stats;
 };
-const buildDiagnostics = (type, parser, streams, entities, strings, warnings, layout) => {
+const buildDiagnostics = (type, parser, streams, entities, strings, warnings, layout, locale) => {
     const diagnostics = warnings.map((message, index) => ({
         level: 'warning',
         code: `warning-${index + 1}`,
@@ -363,22 +397,30 @@ const buildDiagnostics = (type, parser, streams, entities, strings, warnings, la
         code: 'parser',
         message: layout
             ? layout.format === 'oasis'
-                ? '已识别为 OASIS 文本结构夹具，并在浏览器端解析几何预览和结构索引；真实 SEMI 二进制 OASIS 仍走安全索引与后续独立内核路线。'
-                : '已识别为标准 GDSII 二进制版图记录，并在浏览器端解析几何预览和结构索引。'
+                ? getEdaParserText(locale, 'oasisFixture')
+                : getEdaParserText(locale, 'gdsLayout')
             : parser === 'cfb'
-                ? '已识别为 Microsoft Compound File / OLE2 复合文档容器，并在浏览器端解析目录与流。'
-                : '未识别为 CFB 容器，已使用二进制字符串索引模式展示可读信息。'
+                ? getEdaParserText(locale, 'cfbContainer')
+                : getEdaParserText(locale, 'binaryIndex')
     });
     diagnostics.push({
         level: 'info',
         code: 'coverage',
-        message: `已索引 ${streams.length} 个条目、${strings.length} 个可读字符串、${entities.length} 个 EDA 结构候选。`
+        message: getEdaParserText(locale, 'coverage', {
+            streams: streams.length,
+            strings: strings.length,
+            entities: entities.length,
+        })
     });
     if (layout) {
         diagnostics.push({
             level: 'info',
             code: `${layout.format}-layout`,
-            message: `已解析 ${layout.format === 'oasis' ? 'OASIS 结构夹具' : 'GDSII 版图'}: ${layout.structureCount} 个 structure、${layout.elements.length} 个几何/引用/文本元素，可在版图预览面板中拖动查看。`
+            message: getEdaParserText(locale, 'layout', {
+                layout: layout.format === 'oasis' ? 'OASIS fixture' : 'GDSII layout',
+                structures: layout.structureCount,
+                elements: layout.elements.length,
+            })
         });
     }
     const needsSymbol = type === 'olb' && !entities.some(entity => entity.role === 'symbol');
@@ -389,21 +431,21 @@ const buildDiagnostics = (type, parser, streams, entities, strings, warnings, la
             level: 'warning',
             code: 'domain-candidates',
             message: type === 'olb'
-                ? '未发现明确的元件符号候选，文件可能使用了私有二进制编码或需要专业工具导出 ASCII/XML 后再检查。'
+                ? getEdaParserText(locale, 'noSymbol')
                 : type === 'dra'
-                    ? '未发现明确的封装、图形或 padstack 候选，文件可能使用了私有二进制数据库编码。'
+                    ? getEdaParserText(locale, 'noFootprint')
                     : type === 'gds'
-                        ? '未发现明确的 GDSII 版图结构候选。文件可能不是标准 GDSII 二进制或使用了专有封装。'
-                        : '未发现明确的 OASIS 版图结构候选。OASIS 完整几何浏览通常需要专业版图库或独立 WASM/TS 内核，当前前端包会安全展示头部、字符串、属性和二进制结构线索。'
+                        ? getEdaParserText(locale, 'noGds')
+                        : getEdaParserText(locale, 'noOasis')
         });
     }
     return diagnostics;
 };
-const assembleResult = (buffer, type, parser, streamCount, streams, strings, warnings, layout) => {
+const assembleResult = (buffer, type, parser, streamCount, streams, strings, warnings, layout, locale) => {
     const totalStreamBytes = streams.reduce((sum, stream) => sum + stream.size, 0);
     const entities = collectEntities(streams, type);
     const metadata = collectMetadata(streams);
-    const diagnostics = buildDiagnostics(type, parser, streams, entities, strings, warnings, layout);
+    const diagnostics = buildDiagnostics(type, parser, streams, entities, strings, warnings, layout, locale);
     return {
         type,
         parser,
@@ -426,7 +468,7 @@ const assembleResult = (buffer, type, parser, streamCount, streams, strings, war
         layout
     };
 };
-const parseCfbContainer = async (buffer, type) => {
+const parseCfbContainer = async (buffer, type, locale) => {
     const CFB = await import('cfb');
     const container = CFB.parse(toBytes(buffer), { type: 'array' });
     const streamEntries = container.FileIndex
@@ -443,11 +485,11 @@ const parseCfbContainer = async (buffer, type) => {
         return buildStreamView(type, path, entry.name, entry.size || content.byteLength || 0, 'binary', content);
     });
     const warnings = streamEntries.length >= MAX_STREAMS
-        ? [`仅展示前 ${MAX_STREAMS} 个 CFB 项，完整文件仍可下载后在专业 EDA 工具中打开。`]
+        ? [getEdaParserText(locale, 'maxStreams', { count: MAX_STREAMS })]
         : [];
-    return assembleResult(buffer, type, 'cfb', container.FileIndex.length, streams, collectStrings(byteChunks), warnings);
+    return assembleResult(buffer, type, 'cfb', container.FileIndex.length, streams, collectStrings(byteChunks), warnings, undefined, locale);
 };
-const parseBinaryFallback = (buffer, type) => {
+const parseBinaryFallback = (buffer, type, locale) => {
     const bytes = toBytes(buffer);
     const stream = buildStreamView(type, `${type}.${type}`, `${type}.${type}`, buffer.byteLength, 'binary', bytes);
     const layout = type === 'gds'
@@ -460,10 +502,11 @@ const parseBinaryFallback = (buffer, type) => {
         ? layout.warnings
         : oasis
             ? oasis.warnings
-            : ['该文件不是标准 CFB 容器，已退化为安全的二进制字符串索引预览。'];
-    return assembleResult(buffer, type, 'binary', 1, [stream], collectStrings([bytes]), warnings, layout);
+            : [getEdaParserText(locale, 'binaryFallback')];
+    return assembleResult(buffer, type, 'binary', 1, [stream], collectStrings([bytes]), warnings, layout, locale);
 };
-export const parseEdaFile = async (buffer, type = 'olb') => {
+export const parseEdaFile = async (buffer, type = 'olb', options = {}) => {
+    const locale = options.locale || 'zh-CN';
     const normalizedType = type === 'dra'
         ? 'dra'
         : type === 'gds' || type === 'oas' || type === 'oasis'
@@ -471,13 +514,13 @@ export const parseEdaFile = async (buffer, type = 'olb') => {
             : 'olb';
     const bytes = toBytes(buffer);
     if (!isOrcadCompoundFile(bytes)) {
-        return parseBinaryFallback(buffer, normalizedType);
+        return parseBinaryFallback(buffer, normalizedType, locale);
     }
     try {
-        return await parseCfbContainer(buffer, normalizedType);
+        return await parseCfbContainer(buffer, normalizedType, locale);
     }
     catch (error) {
-        const fallback = parseBinaryFallback(buffer, normalizedType);
+        const fallback = parseBinaryFallback(buffer, normalizedType, locale);
         fallback.warnings.unshift(error instanceof Error ? error.message : String(error));
         fallback.diagnostics.unshift({
             level: 'warning',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/renderer-eda",
-  "version": "2.1.2",
+  "version": "2.1.4",
   "private": false,
   "type": "module",
   "description": "Standalone EDA renderer plugin for Flyfish File Viewer with OLB, DRA, GDSII, and OASIS structure preview.",
@@ -57,9 +57,9 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@file-viewer/core": "^2.1.2",
-    "@file-viewer/eda-layout": "^2.1.2",
-    "@file-viewer/eda-orcad": "^2.1.2",
+    "@file-viewer/core": "^2.1.4",
+    "@file-viewer/eda-layout": "^2.1.4",
+    "@file-viewer/eda-orcad": "^2.1.4",
     "cfb": "^1.2.2"
   },
   "devDependencies": {