@file-viewer/renderer-cad 3.0.1 → 3.0.3

package/README.en.md

@@ -49,3 +49,27 @@ For private deployments, override them with `options.cad.wasmPath`, `options.cad
 ## Migration Note
 
 CAD preview has moved completely out of `@file-viewer/core`. Core now only keeps the asset manifest, shared types, and a compatibility error message, and it no longer installs `@flyfish-dev/cad-viewer` by default. Install this package and pass it through `renderers`, or use `@file-viewer/preset-all` for the complete CAD experience.
+
+## Monochrome plot mode
+
+Set `cad.colorMode` to `source` or `monochrome`. Monochrome rendering uses the CAD engine's entity-color policy rather than a CSS filter, keeping Canvas, WebGL, text overlays and native DWF output consistent while preserving alpha, line types, line weights and source data.
+
+Source mode defaults to a dark background; monochrome defaults to black lines on white paper. Adaptive contrast makes lines and text near the background color readable. Use `cad.canvasOptions.contrastMode: 'preserve'` for exact source colors. Explicit `cad.canvasOptions.background` / `cad.dwfBackground` values survive mode changes.
+
+```ts
+{
+  cad: {
+    colorMode: 'monochrome',
+    monochromeColor: '#000000',
+    showColorModeToggle: true,
+  },
+}
+```
+
+### Images, print and offline HTML
+
+Select the color mode, then use Print or HTML in the shared toolbar. Output redraws and captures the current view, including WebGL lines and text overlays, without layer panels or controls. HTML embeds a PNG instead of a temporary blob URL. The print window supports the browser's Save as PDF and retains File Viewer permission checks, watermarks and masks.
+
+PNG and JPEG buttons download the same rendered view, including configured text or image watermarks. Both `toolbar.permissions.download` and `toolbar.permissions['export-html']` must allow the operation. The owning viewer runs its normal `beforeOperation`, toolbar `beforeOperation` and `beforeDownload` hooks before capture; cancellation or a document/permission change prevents the download. Use `cad.showImageExport: false` to hide these renderer-local buttons. A missing watermark fails explicitly without breaking the live preview. Print masks apply to Print, not to image downloads.
+
+This is a raster snapshot of the current camera view / current DWF page, not a vector conversion or batch export of every sheet. Use Fit first to include the full drawing. Original-file download never changes the input bytes.

package/README.md

@@ -49,3 +49,27 @@ const options = {
 ## 迁移说明
 
 CAD 预览已经从 `@file-viewer/core` 中彻底移出，core 只保留资产 manifest、类型和兼容错误提示，不再默认安装 `@flyfish-dev/cad-viewer`。完整 CAD 能力请安装本包并传入 `renderers`，或直接使用 `@file-viewer/preset-all`。
+
+## 黑白出图模式
+
+`cad.colorMode` 可设为 `source` 或 `monochrome`。黑白模式通过 CAD 引擎的实体颜色策略实现，不使用 CSS 滤镜，因此 Canvas、WebGL、文字覆盖层及原生 DWF 渲染可保持一致，同时保留透明度、线型、线宽和源文件数据。
+
+默认原色模式使用深色背景，黑白模式使用白纸黑线。自适应对比度会提高与背景过近的线条和文字的可见性；要求严格显示源颜色时可设 `cad.canvasOptions.contrastMode: 'preserve'`。显式设置的 `cad.canvasOptions.background` / `cad.dwfBackground` 不会被模式切换覆盖。
+
+```ts
+{
+  cad: {
+    colorMode: 'monochrome',
+    monochromeColor: '#000000',
+    showColorModeToggle: true,
+  },
+}
+```
+
+### 图片、打印与离线 HTML
+
+先选择原色或黑白模式，再使用统一工具栏的“打印”或“HTML”。输出会重新绘制并立即捕获当前视图，包含 WebGL 线条和文字覆盖层，不含图层面板或工具栏。HTML 内嵌 PNG，不依赖临时 blob 地址；打印窗口可使用浏览器的“另存为 PDF”，并保留 File Viewer 的权限检查、水印和遮罩。
+
+CAD 工具栏的 PNG、JPEG 按钮下载同一视图，并保留配置的文本或图片水印。`toolbar.permissions.download` 与 `toolbar.permissions['export-html']` 都必须允许；捕获前由所属组件执行既有 `beforeOperation`、工具栏 `beforeOperation` 和 `beforeDownload` 钩子。取消操作、切换文档或撤销权限后不会下载旧快照。`cad.showImageExport: false` 可隐藏这两个格式专用按钮。水印资源不可读时明确失败，预览仍保持可用。打印遮罩仅作用于打印，不作用于图片下载。
+
+这里输出的是当前相机视图 / 当前 DWF 页的栅格快照，不是整个 CAD 文件的矢量转换，也不会自动批量打印其他图纸页。需要完整图纸时先点击“适配”。原文件下载始终保持输入字节不变。

package/dist/cad.js

@@ -1,6 +1,8 @@
 import { CadViewer, inferEntityKind, } from '@flyfish-dev/cad-viewer';
 import { resolveFileViewerCadAssetUrls, resolveFileViewerRuntimeAssetBaseUrl, } from '@file-viewer/core/assets';
-import { createFileViewerViewStateChange, createFileViewerViewStateChangeEmitter, createFileViewerTranslator, createFileViewerZoomChangeEmitter, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, resolveFileViewerLocale, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from '@file-viewer/core';
+import { createFileViewerViewStateChange, createFileViewerViewStateChangeEmitter, createFileViewerTranslator, createFileViewerZoomChangeEmitter, createFileViewerCanvasImageBlob, isFileViewerSnapshotDownloadPermitted, registerFileViewerViewStateProvider, registerFileViewerZoomProvider, resolveFileViewerLocale, unregisterFileViewerViewStateProvider, unregisterFileViewerZoomProvider, } from '@file-viewer/core';
+import { applyCadViewerColorMode, normalizeFileViewerCadColorMode, resolveFileViewerCadMonochromeColor, resolveFileViewerCadCanvasOptions, resolveCadViewerSourceDocument, supportsCadViewerColorMode, } from './colorMode.js';
+import { captureFileViewerCadCanvas, createFileViewerCadExportAdapter } from './export.js';
 const CAD_WORKER_TIMEOUT = 120000;
 const CAD_DEFAULT_FIT_PADDING = 0.92;
 const CAD_BOUNDS_EPSILON = 1e-9;
@@ -8,12 +10,21 @@ const CAD_BEST_FIT_OUTLIER_RATIO = 8;
 const CAD_NATIVE_MIN_ZOOM_RATIO = 0.05;
 const CAD_NATIVE_MAX_ZOOM_RATIO = 64;
 const cadStyle = `
-.cad-shell{display:flex;height:100%;min-height:100%;flex-direction:column;background:#f5f7fb;color:#142335}
+.cad-shell{display:flex;height:100%;min-height:100%;flex-direction:column;background:#f5f7fb;color:#142335;container-type:inline-size;container-name:file-viewer-cad}
 .cad-shell *{box-sizing:border-box}
-.cad-toolbar{display:flex;min-height:48px;align-items:center;justify-content:space-between;gap:16px;padding:0 14px;border-bottom:1px solid rgba(15,23,42,.08);background:#fff}
+.cad-toolbar{display:flex;flex-shrink:0;min-height:48px;align-items:center;justify-content:space-between;gap:16px;padding:0 14px;border-bottom:1px solid rgba(15,23,42,.08);background:#fff}
 .cad-tools,.cad-meta{display:flex;align-items:center;gap:8px}
+.cad-tools{flex-wrap:wrap;padding:6px 0}
+.cad-tools button.cad-export-image{min-width:44px;min-height:40px;padding:0 10px;white-space:nowrap}
+.cad-tools button[hidden]{display:none}
+.cad-tools button:disabled{cursor:not-allowed;opacity:.46}
+.cad-export-error{margin:0;padding:6px 14px;background:#fff4ed;color:#b42318;font-size:12px}
+.cad-export-error[hidden]{display:none}
 .cad-tools button{min-width:34px;min-height:30px;border:0;border-radius:8px;background:rgba(15,23,42,.06);color:#25344c;cursor:pointer;font-weight:800;letter-spacing:0;transition:background-color .18s ease,color .18s ease}
 .cad-tools button:hover{background:rgba(31,150,110,.14);color:#0f8f62}
+.cad-tools button.cad-color-mode{min-width:52px;padding:0 10px;font-size:12px}
+.cad-tools button.cad-color-mode[aria-pressed='true']{background:#0f172a;color:#fff}
+.cad-tools button.cad-color-mode:disabled{cursor:not-allowed;opacity:.46}
 .cad-zoom,.cad-meta span{color:#64748b;font-size:12px;font-weight:800;letter-spacing:0}
 .cad-meta span{border-radius:999px;padding:5px 9px;background:rgba(15,23,42,.06)}
 .cad-body{display:grid;min-height:0;flex:1;grid-template-columns:minmax(176px,236px) minmax(0,1fr) minmax(142px,176px);background:#eef2f7}
@@ -94,7 +105,8 @@ const cadStyle = `
 [data-viewer-theme='dark'] .cad-canvas-wrap{background:linear-gradient(90deg,rgba(148,163,184,.08) 1px,transparent 1px),linear-gradient(180deg,rgba(148,163,184,.08) 1px,transparent 1px),#090d14;background-size:28px 28px}
 [data-viewer-theme='dark'] .cad-state{background:rgba(15,23,42,.92);color:#cbd5e1;box-shadow:0 18px 44px rgba(0,0,0,.34)}
 @media (prefers-color-scheme:dark){[data-viewer-theme='system'] .cad-shell{background:#111827;color:#e5edf6}[data-viewer-theme='system'] .cad-body{background:#0d1117}[data-viewer-theme='system'] .cad-toolbar,[data-viewer-theme='system'] .cad-layers,[data-viewer-theme='system'] .cad-inspector{border-color:rgba(139,148,158,.2);background:#111827;color:#e5edf6}[data-viewer-theme='system'] .cad-layers-head{border-color:rgba(139,148,158,.2);background:rgba(17,24,39,.96);color:#f8fafc}[data-viewer-theme='system'] .cad-tools button,[data-viewer-theme='system'] .cad-meta span,[data-viewer-theme='system'] .cad-inspector dl div{background:#1f2937;color:#cbd5e1}[data-viewer-theme='system'] .cad-layers button,[data-viewer-theme='system'] .cad-inspector strong,[data-viewer-theme='system'] .cad-inspector dd{color:#e5edf6}[data-viewer-theme='system'] .cad-layers button:hover{background:#1f2937}[data-viewer-theme='system'] .cad-zoom,[data-viewer-theme='system'] .cad-meta span,[data-viewer-theme='system'] .cad-inspector dt,[data-viewer-theme='system'] .cad-layers-head span{color:#94a3b8}[data-viewer-theme='system'] .cad-canvas-wrap{background:linear-gradient(90deg,rgba(148,163,184,.08) 1px,transparent 1px),linear-gradient(180deg,rgba(148,163,184,.08) 1px,transparent 1px),#090d14;background-size:28px 28px}[data-viewer-theme='system'] .cad-state{background:rgba(15,23,42,.92);color:#cbd5e1;box-shadow:0 18px 44px rgba(0,0,0,.34)}}
-@media (max-width:860px){.cad-body,.cad-body.without-layers{grid-template-columns:minmax(0,1fr)}.cad-layers,.cad-inspector{display:none}}
+@media (max-width:860px){.cad-body,.cad-body.without-layers{grid-template-columns:minmax(0,1fr)}.cad-layers,.cad-inspector,.cad-meta{display:none}.cad-tools{flex:1}.cad-tools button{min-width:44px;min-height:40px}}
+@container file-viewer-cad (max-width:600px){.cad-meta{display:none}.cad-tools{flex:1}.cad-tools button{min-width:44px;min-height:40px}}
 `;
 const createStyle = () => {
     const style = document.createElement('style');
@@ -643,11 +655,13 @@ const resolveLayerSourceNames = (document, layer) => {
     return Array.from(names);
 };
 export default async function renderCad(buffer, target, type = 'dxf', context) {
-    var _a;
+    var _a, _b;
     const normalizedType = normalizeType(type);
     const options = ((_a = context === null || context === void 0 ? void 0 : context.options) === null || _a === void 0 ? void 0 : _a.cad) || {};
     const t = createFileViewerTranslator(context === null || context === void 0 ? void 0 : context.options);
     const locale = resolveFileViewerLocale(context === null || context === void 0 ? void 0 : context.options);
+    const monochromeColor = resolveFileViewerCadMonochromeColor(options.monochromeColor);
+    let colorMode = normalizeFileViewerCadColorMode(options.colorMode);
     let status = 'loading';
     let progressMessage = t('cad.state.loadingViewer');
     let errorMessage = '';
@@ -663,6 +677,7 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
     let fitViewActive = true;
     let nativeZoomRatio = 1;
     let disposed = false;
+    let exportingImage = false;
     const style = createStyle();
     const shell = createElement('div', 'cad-shell');
     shell.dataset.viewerZoomProvider = 'cad';
@@ -672,18 +687,61 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
     const zoomOutButton = createElement('button', undefined, '-');
     const zoomText = createElement('span', 'cad-zoom', '100%');
     const zoomInButton = createElement('button', undefined, '+');
+    const colorModeButton = createElement('button', 'cad-color-mode');
+    colorModeButton.hidden = options.showColorModeToggle === false;
     const meta = createElement('div', 'cad-meta');
     const typeMeta = createElement('span', undefined, normalizedType.toUpperCase());
     const backendMeta = createElement('span', undefined, 'AUTO');
-    [fitButton, zoomOutButton, zoomInButton].forEach(button => {
+    [fitButton, zoomOutButton, zoomInButton, colorModeButton].forEach(button => {
         button.type = 'button';
     });
     fitButton.title = t('cad.toolbar.fit');
     zoomOutButton.title = t('cad.toolbar.zoomOut');
     zoomInButton.title = t('cad.toolbar.zoomIn');
-    tools.append(fitButton, zoomOutButton, zoomText, zoomInButton);
+    tools.append(fitButton, zoomOutButton, zoomText, zoomInButton, colorModeButton);
+    const imageButtons = ['png', 'jpeg'].map(format => {
+        const button = createElement('button', `cad-export-image cad-export-${format}`, format.toUpperCase());
+        button.type = 'button';
+        button.title = t('cad.toolbar.exportImage', { format: format.toUpperCase() });
+        button.setAttribute('aria-label', button.title);
+        button.hidden = !(context === null || context === void 0 ? void 0 : context.requestSnapshotDownload) || options.showImageExport === false ||
+            !isFileViewerSnapshotDownloadPermitted(context === null || context === void 0 ? void 0 : context.options);
+        button.addEventListener('click', async () => {
+            var _a;
+            if (disposed || status !== 'ready' || exportingImage)
+                return;
+            exportingImage = true;
+            exportError.hidden = true;
+            syncState();
+            try {
+                await ((_a = context === null || context === void 0 ? void 0 : context.requestSnapshotDownload) === null || _a === void 0 ? void 0 : _a.call(context, async (watermark) => {
+                    const snapshot = await captureFileViewerCadCanvas(() => viewer);
+                    const blob = await createFileViewerCanvasImageBlob(snapshot, format, watermark, snapshot.width / stage.clientWidth);
+                    const name = buildFileName().replace(/\.[^.]+$/, '') || 'drawing';
+                    return { blob, filename: `${name}.${format === 'jpeg' ? 'jpg' : 'png'}` };
+                }));
+            }
+            catch (error) {
+                if (!disposed) {
+                    exportError.textContent = t('cad.error.exportFailed', { message: error instanceof Error ? error.message : String(error) });
+                    exportError.hidden = false;
+                    console.error(error);
+                }
+            }
+            finally {
+                exportingImage = false;
+                if (!disposed)
+                    syncState();
+            }
+        });
+        tools.append(button);
+        return button;
+    });
     meta.append(typeMeta, backendMeta);
     toolbar.append(tools, meta);
+    const exportError = createElement('p', 'cad-export-error');
+    exportError.setAttribute('role', 'alert');
+    exportError.hidden = true;
     const body = createElement('div', 'cad-body without-layers');
     const layersPanel = createElement('aside', 'cad-layers');
     layersPanel.hidden = true;
@@ -705,7 +763,7 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
     warningText.hidden = true;
     inspector.append(inspectorTitle, inspectorList, warningText);
     body.append(layersPanel, canvasWrap, inspector);
-    shell.append(toolbar, body);
+    shell.append(toolbar, exportError, body);
     target.replaceChildren(style, shell);
     const buildFileName = () => {
         return (context === null || context === void 0 ? void 0 : context.filename) || `drawing.${normalizedType}`;
@@ -749,6 +807,8 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
             status,
             view: viewState ? { ...viewState } : null,
             backend: renderStats === null || renderStats === void 0 ? void 0 : renderStats.backend,
+            colorMode,
+            monochromeColor: colorMode === 'monochrome' ? monochromeColor : undefined,
             layerCount: layers.length,
             visibleLayers: layers
                 .filter(layer => layer.isVisible !== false && !layer.isFrozen)
@@ -885,12 +945,15 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
                 : layer.name;
             button.setAttribute('aria-pressed', String(layerVisible));
             const color = createElement('span', 'cad-layer-color');
-            if (typeof layer.color === 'string') {
+            if (colorMode === 'monochrome') {
+                color.style.background = monochromeColor;
+            }
+            else if (typeof layer.color === 'string') {
                 color.style.background = layer.color;
             }
             button.append(color, createElement('span', undefined, layer.name));
             button.addEventListener('click', () => {
-                const document = viewer === null || viewer === void 0 ? void 0 : viewer.getDocument();
+                const document = resolveCadViewerSourceDocument(viewer);
                 if (!document) {
                     return;
                 }
@@ -915,8 +978,21 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
         }));
     };
     const syncState = () => {
+        imageButtons.forEach(button => {
+            button.disabled = status !== 'ready' || exportingImage || !viewer ||
+                typeof viewer.captureCanvas !== 'function';
+        });
         zoomText.textContent = `${getZoomPercent()}%`;
         backendMeta.textContent = ((renderStats === null || renderStats === void 0 ? void 0 : renderStats.backend) || 'auto').toUpperCase();
+        const colorModeSupported = supportsCadViewerColorMode(viewer);
+        colorModeButton.disabled = status !== 'ready' || !colorModeSupported;
+        colorModeButton.setAttribute('aria-pressed', String(colorMode === 'monochrome'));
+        colorModeButton.textContent = t(colorMode === 'monochrome'
+            ? 'cad.toolbar.monochrome'
+            : 'cad.toolbar.colorSource');
+        colorModeButton.title = t(colorMode === 'monochrome'
+            ? 'cad.toolbar.colorSource'
+            : 'cad.toolbar.monochrome');
         state.hidden = status === 'ready';
         state.classList.toggle('error', status === 'error');
         if (status === 'loading') {
@@ -1054,20 +1130,21 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
     fitButton.addEventListener('click', () => fitToView());
     zoomInButton.addEventListener('click', zoomIn);
     zoomOutButton.addEventListener('click', zoomOut);
+    colorModeButton.addEventListener('click', () => {
+        const previousMode = colorMode;
+        colorMode = colorMode === 'monochrome' ? 'source' : 'monochrome';
+        if (!applyCadViewerColorMode(viewer, colorMode, monochromeColor, options)) {
+            colorMode = previousMode;
+            syncState();
+            return;
+        }
+        syncUi();
+        emitCadViewStateChange('cad-view-change', 'user');
+    });
     const createViewer = () => {
         var _a, _b, _c, _d, _e, _f, _g;
         const { wasmPath, workerUrl, dwfWasmUrl } = resolveFileViewerCadAssetUrls(options, getCadDocumentBaseUrl(target));
-        const canvasOptions = {
-            background: '#f8fafc',
-            foreground: '#0f172a',
-            contrastMode: 'adaptive',
-            minColorContrast: 2.4,
-            showPageBounds: true,
-            showUnsupportedMarkers: true,
-            enableSpatialIndex: true,
-            maxVisibleTextLabels: 2400,
-            ...(options.canvasOptions || {}),
-        };
+        const canvasOptions = resolveFileViewerCadCanvasOptions(options, colorMode);
         const nextViewer = new CadViewer({
             container: stage,
             nativeHost,
@@ -1084,7 +1161,7 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
             keepRaw: (_e = options.keepRaw) !== null && _e !== void 0 ? _e : false,
             dwfPreferWebgl: (_f = options.dwfPreferWebgl) !== null && _f !== void 0 ? _f : true,
             dwfPreferWasm: (_g = options.dwfPreferWasm) !== null && _g !== void 0 ? _g : true,
-            dwfBackground: options.dwfBackground || '#f8fafc',
+            dwfBackground: options.dwfBackground,
             dwfMaxDevicePixelRatio: options.dwfMaxDevicePixelRatio,
             dwfMaxCanvasPixels: options.dwfMaxCanvasPixels,
             dwfMaxGpuCacheBytes: options.dwfMaxGpuCacheBytes,
@@ -1094,6 +1171,7 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
             dwfMaxOverviewStrokeCssPx: options.dwfMaxOverviewStrokeCssPx,
             dwfMinTextCssPx: options.dwfMinTextCssPx,
             dwfMinFilledAreaCssPx: options.dwfMinFilledAreaCssPx,
+            ...{ colorMode, monochromeColor },
             autoFit: true,
             canvasOptions,
             onLoadProgress: updateProgress,
@@ -1210,11 +1288,14 @@ export default async function renderCad(buffer, target, type = 'dxf', context) {
         resizeObserver.observe(stage);
     }
     syncUi();
+    (_b = context === null || context === void 0 ? void 0 : context.registerExportAdapter) === null || _b === void 0 ? void 0 : _b.call(context, createFileViewerCadExportAdapter(() => viewer, context.filename, () => stage.querySelector('.dwfv-stage') || stage));
     void loadCad();
     return {
         $el: shell,
         unmount() {
+            var _a;
             disposed = true;
+            (_a = context === null || context === void 0 ? void 0 : context.registerExportAdapter) === null || _a === void 0 ? void 0 : _a.call(context, null);
             unregisterFileViewerViewStateProvider(shell);
             unregisterFileViewerZoomProvider(shell);
             abortController === null || abortController === void 0 ? void 0 : abortController.abort();

package/dist/colorMode.d.ts

@@ -0,0 +1,15 @@
+import type { FileViewerCadColorMode, FileViewerCadOptions } from '@file-viewer/core';
+import type { CanvasViewerOptions } from '@flyfish-dev/cad-viewer';
+export interface CadViewerColorModeAdapter {
+    setColorMode?: (mode: FileViewerCadColorMode, monochromeColor?: string) => void;
+    getColorMode?: () => FileViewerCadColorMode;
+    getMonochromeColor?: () => string | undefined;
+    setCanvasOptions?: (options: CanvasViewerOptions) => void;
+    isNativeRendererActive?: () => boolean;
+}
+export declare function normalizeFileViewerCadColorMode(value: unknown): FileViewerCadColorMode;
+export declare function resolveFileViewerCadMonochromeColor(value: unknown, fallback?: string): string;
+export declare function resolveFileViewerCadCanvasOptions(options: FileViewerCadOptions, mode: FileViewerCadColorMode): CanvasViewerOptions;
+export declare function supportsCadViewerColorMode(value: unknown): value is CadViewerColorModeAdapter;
+export declare function resolveCadViewerSourceDocument(viewer: unknown): unknown;
+export declare function applyCadViewerColorMode(viewer: unknown, mode: FileViewerCadColorMode, monochromeColor: string, options?: FileViewerCadOptions): boolean;

package/dist/colorMode.js

@@ -0,0 +1,47 @@
+export function normalizeFileViewerCadColorMode(value) {
+    return value === 'monochrome' ? 'monochrome' : 'source';
+}
+export function resolveFileViewerCadMonochromeColor(value, fallback = '#000000') {
+    if (typeof value === 'string' && value.trim())
+        return value.trim();
+    return fallback;
+}
+export function resolveFileViewerCadCanvasOptions(options, mode) {
+    return {
+        background: mode === 'monochrome' ? '#ffffff' : '#05070d',
+        foreground: mode === 'monochrome'
+            ? resolveFileViewerCadMonochromeColor(options.monochromeColor)
+            : '#f8fafc',
+        contrastMode: 'adaptive',
+        minColorContrast: 2.4,
+        showPageBounds: true,
+        showUnsupportedMarkers: true,
+        enableSpatialIndex: true,
+        maxVisibleTextLabels: 2400,
+        ...options.canvasOptions,
+    };
+}
+export function supportsCadViewerColorMode(value) {
+    return Boolean(value && typeof value.setColorMode === 'function');
+}
+export function resolveCadViewerSourceDocument(viewer) {
+    var _a, _b, _c;
+    const candidate = viewer;
+    return (_b = (_a = candidate === null || candidate === void 0 ? void 0 : candidate.getSourceDocument) === null || _a === void 0 ? void 0 : _a.call(candidate)) !== null && _b !== void 0 ? _b : (_c = candidate === null || candidate === void 0 ? void 0 : candidate.getDocument) === null || _c === void 0 ? void 0 : _c.call(candidate);
+}
+export function applyCadViewerColorMode(viewer, mode, monochromeColor, options) {
+    var _a, _b, _c;
+    if (!supportsCadViewerColorMode(viewer))
+        return false;
+    (_a = viewer.setColorMode) === null || _a === void 0 ? void 0 : _a.call(viewer, mode, monochromeColor);
+    if (options) {
+        const canvasOptions = resolveFileViewerCadCanvasOptions(options, mode);
+        // The native setter also forwards the canvas background to DWF. Keep an
+        // explicitly configured DWF background instead of overwriting it on toggle.
+        if (((_b = viewer.isNativeRendererActive) === null || _b === void 0 ? void 0 : _b.call(viewer)) && options.dwfBackground) {
+            canvasOptions.background = options.dwfBackground;
+        }
+        (_c = viewer.setCanvasOptions) === null || _c === void 0 ? void 0 : _c.call(viewer, canvasOptions);
+    }
+    return true;
+}

package/dist/export.d.ts

@@ -0,0 +1,6 @@
+import type { FileRenderExportAdapter } from '@file-viewer/core';
+export interface CadCanvasCaptureAdapter {
+    captureCanvas?: () => Promise<HTMLCanvasElement>;
+}
+export declare function captureFileViewerCadCanvas(getViewer: () => CadCanvasCaptureAdapter | null): Promise<HTMLCanvasElement>;
+export declare function createFileViewerCadExportAdapter(getViewer: () => CadCanvasCaptureAdapter | null, filename?: string, getPage?: () => HTMLElement): FileRenderExportAdapter;

package/dist/export.js

@@ -0,0 +1,28 @@
+export async function captureFileViewerCadCanvas(getViewer) {
+    const viewer = getViewer();
+    if (!(viewer === null || viewer === void 0 ? void 0 : viewer.captureCanvas))
+        throw new Error('The CAD engine does not support canvas snapshots.');
+    const snapshot = await viewer.captureCanvas();
+    if (getViewer() !== viewer)
+        throw new Error('The CAD document changed during export.');
+    return snapshot;
+}
+export function createFileViewerCadExportAdapter(getViewer, filename = 'CAD drawing', getPage) {
+    return {
+        includeDocumentStyles: false,
+        getPrintMaskPages: getPage ? () => [getPage()] : undefined,
+        async toHtml() {
+            const snapshot = await captureFileViewerCadCanvas(getViewer);
+            const image = snapshot.ownerDocument.createElement('img');
+            image.src = snapshot.toDataURL('image/png');
+            image.alt = filename;
+            image.width = snapshot.width;
+            image.height = snapshot.height;
+            image.style.cssText = 'display:block;max-width:100%;height:auto;margin:0 auto;';
+            const page = snapshot.ownerDocument.createElement('div');
+            page.dataset.viewerPrintPageIndex = '0';
+            page.appendChild(image);
+            return page.outerHTML;
+        },
+    };
+}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 import { type FileRenderHandler, type FileViewerRenderedInstance, type FileViewerRendererPlugin, type RendererDefinition } from '@file-viewer/core';
+export { applyCadViewerColorMode, normalizeFileViewerCadColorMode, resolveCadViewerSourceDocument, resolveFileViewerCadMonochromeColor, supportsCadViewerColorMode, } from './colorMode.js';
+export type { CadViewerColorModeAdapter } from './colorMode.js';
 export declare const cadRendererDefinition: RendererDefinition;
 export declare const renderFileViewerCad: FileRenderHandler<FileViewerRenderedInstance, HTMLDivElement>;
 export declare const cadRenderer: FileViewerRendererPlugin<FileRenderHandler<FileViewerRenderedInstance, HTMLDivElement>>;

package/dist/index.js

@@ -1,4 +1,5 @@
 import { DEFAULT_RENDERER_DEFINITIONS, } from '@file-viewer/core';
+export { applyCadViewerColorMode, normalizeFileViewerCadColorMode, resolveCadViewerSourceDocument, resolveFileViewerCadMonochromeColor, supportsCadViewerColorMode, } from './colorMode.js';
 const cadDefinition = DEFAULT_RENDERER_DEFINITIONS.find(definition => definition.id === 'cad');
 if (!cadDefinition) {
     throw new Error('@file-viewer/renderer-cad could not locate the shared CAD format definition.');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/renderer-cad",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "private": false,
   "type": "module",
   "description": "Standalone CAD renderer plugin for File Viewer powered by @flyfish-dev/cad-viewer.",
@@ -56,8 +56,8 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@file-viewer/core": "3.0.1",
-    "@flyfish-dev/cad-viewer": "0.8.0"
+    "@file-viewer/core": "3.0.3",
+    "@flyfish-dev/cad-viewer": "0.8.2"
   },
   "devDependencies": {
     "typescript": "^6.0.3"
@@ -65,6 +65,7 @@
   "license": "Apache-2.0",
   "scripts": {
     "build": "tsc -b tsconfig.json",
-    "type-check": "tsc -b tsconfig.json"
+    "type-check": "tsc -b tsconfig.json",
+    "verify:color-mode": "node scripts/verify-color-mode.mjs"
   }
 }