[Bug] Stamp annotations imported via importAnnotations are invisible
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 38/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 活発
- 技術スタック
- javascript, typescript
- 領域
- frontend
調査の方向性
Start by running the reproduction HTML from the issue: place a stamp, export with exportAnnotations, re-init, then importAnnotations, and check whether the stamp renders. The payload names only the annotation plugin API (importAnnotations, exportAnnotations, the stamp tool) and the stamp's ctx.data ArrayBuffer, not specific files. Done means a stamp imported from exported data renders in the same position as before the viewer was destroyed.
索引モデルが issue の本文から書いたものです。
説明
Description
When exporting a stamp annotation and subsequently importing it back into a freshly initialized viewer via importAnnotations, the stamp becomes completely invisible.
The data exported by exportAnnotations contains a valid ArrayBuffer for the stamp's ctx.data, and importAnnotations accepts it without throwing any errors. However, the stamp fails to render visually. It seems the appearance stream (/AP) is being lost or ignored when the stamp is recreated during the import phase.
Steps to Reproduce
We have created a zero-dependency Minimal Reproducible Example (MRE) using the raw @embedpdf/snippet library to prove this is not related to external frameworks or serialization:
- Save the HTML file below and open it in a browser.
- Click "1. Init & Load PDF".
- Place a Stamp anywhere on the document.
- Click "2. Export & Destroy" (This saves the raw
exportAnnotations()output to an in-memory variable and completely clears the DOM/viewer instance). - Click "3. Re-Init & Import" (This spawns a fresh viewer, loads the PDF, and calls
importAnnotations(savedAnnotations)using the raw memory data).
Expected Behavior
The stamp should be fully visible exactly where it was placed before the viewer was destroyed.
Actual Behavior
The import succeeds silently without errors, but the stamp is completely invisible on the document.
Minimal Reproducible Example
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>EmbedPDF Stamp MRE</title>
<style>
body, html { margin: 0; padding: 0; height: 100%; font-family: sans-serif; display: flex; flex-direction: column; }
#controls { padding: 15px; background: #f0f0f0; border-bottom: 1px solid #ccc; display: flex; gap: 10px; align-items: center; }
button { padding: 8px 16px; cursor: pointer; }
#status { font-weight: bold; margin-left: 20px; color: #333; }
#viewer-container { flex: 1; position: relative; background: #888; }
#pdf-viewer { width: 100%; height: 100%; }
</style>
</head>
<body>
<div id="controls">
<button id="btn-load">1. Init & Load PDF</button>
<button id="btn-export">2. Export & Destroy</button>
<button id="btn-import">3. Re-Init & Import</button>
<span id="status">Ready. Click 'Init & Load PDF'</span>
</div>
<div id="viewer-container">
<div id="pdf-viewer"></div>
</div>
<script type="module">
import EmbedPDF from 'https://cdn.jsdelivr.net/npm/@embedpdf/snippet@2/dist/embedpdf.js';
const pdfUrl = 'https://raw.githubusercontent.com/mozilla/pdf.js/ba2edeae/web/compressed.tracemonkey-pldi-09.pdf';
let savedAnnotations = null;
let viewerInstance = null;
let annotationApi = null;
async function initViewer() {
const targetId = 'pdf-viewer';
document.getElementById('viewer-container').innerHTML = `<div id="${targetId}"></div>`;
viewerInstance = EmbedPDF.init({
type: 'container',
target: document.getElementById(targetId),
documentManager: { maxDocuments: 1 }
});
const registry = await viewerInstance.registry;
const docManager = registry.getPlugin('document-manager').provides();
annotationApi = registry.getPlugin('annotation').provides();
await docManager.openDocumentUrl({
url: pdfUrl,
documentId: 'test-document',
autoActivate: true
});
}
document.getElementById('btn-load').onclick = async () => {
document.getElementById('status').textContent = 'Loading...';
await initViewer();
annotationApi.setActiveTool('stamp');
document.getElementById('status').textContent = 'Loaded! Please place a STAMP, then click step 2.';
};
document.getElementById('btn-export').onclick = async () => {
if (!annotationApi) return;
document.getElementById('status').textContent = 'Exporting...';
savedAnnotations = await new Promise((resolve) => {
annotationApi.exportAnnotations().wait(
items => resolve(items),
err => { console.error(err); resolve([]); }
);
});
document.getElementById('viewer-container').innerHTML = '';
viewerInstance = null;
annotationApi = null;
document.getElementById('status').textContent = 'Destroyed! Annotations saved to variable. Now click step 3.';
};
document.getElementById('btn-import').onclick = async () => {
if (!savedAnnotations) return alert("Please export first!");
document.getElementById('status').textContent = 'Re-initializing...';
await initViewer();
const result = annotationApi.importAnnotations(savedAnnotations);
if (result && typeof result.wait === 'function') {
await new Promise(resolve => result.wait(resolve, resolve));
}
document.getElementById('status').textContent = 'Imported! The stamp is now invisible.';
};
</script>
</body>
</html>
Environment
- EmbedPDF Version:
@embedpdf/snippet@2 - Browser: Firefox 156.01
- OS: Arch Linux
- 主要言語
- TypeScript
- スター
- 4.5k
- フォーク
- 317
- 平均マージ
- 10時間 16分
- マージ済み PR(30日)
- 174
環境構築
このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
embedpdf/embed-pdf-viewer のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 88/100
embedpdf/embed-pdf-viewer#1098 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 85/100
embedpdf/embed-pdf-viewer#921 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 79/100
embedpdf/embed-pdf-viewer#889 ·
メンテナーはふだん 1 日以内に返信
-
[v2] TaskQueue: equal-priority tasks can run out of order when a randomUUID id starts with digitsオープン
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
embedpdf/embed-pdf-viewer#874 ·
メンテナーはふだん 1 日以内に返信
-
Free text stays scrolled to the caret after editing ends対応中かも @chahore が 36 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
embedpdf/embed-pdf-viewer#861 ·
メンテナーはふだん 1 日以内に返信
embedpdf/embed-pdf-viewer の issue をすべて見る
似ている issue
-
community first-timers-only good first issue hacktoberfest help wanted low hanging fruit up-for-grabs
難易度 1/5 1時間未満 初心者へのやさしさ 85/100
lingdojo/kana-dojo#34223 · コメント 1 件 · リアクション 5 件 ·
メンテナーはふだん 1 日以内に返信
-
bug status: needs triage
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
mastra-ai/mastra#30587 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
area:web p2 product:business triage:active type:bug
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
cuadrao-ai/argus#2228 ·
メンテナーはふだん 1 日以内に返信
-
.Needs Triage .Team/Metabot Priority:P3 Type:Bug
難易度 2/5 1〜3時間 初心者へのやさしさ 73/100
metabase/metabase#87252 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
NuGet registry builds every URL from ROOT_URL, ignoring the host the client used対応中かも @gritse が今日担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
メンテナーはふだん 1 日以内に返信