Webアプリ↔Excel SVGクリップボード診断Kit｜双方向コピペ・PNGフォールバック・保存再オープン

WebアプリとExcelの間でSVGを双方向にコピー＆ペーストするとき、「どこでベクターとして扱えなくなったのか」を自分の環境で切り分けるための診断Kitです。

Web→Excel、Excel→Web、保存→終了→再オープン後のRound-tripを分け、Clipboard・SVG構造・receiver reject・PNG fallbackのどこで結果が変わったかを追います。

【こんな症状向け】

・Webの図をSVGファイル保存なしでExcelへCtrl+Vしたい

・ExcelからWebへ戻すとPNG／Raster扱いになる

・image/svg+xmlが見えるのにVector importできない

・PasteEventとAsync Clipboardで見える形式が違う

・Freshでは通るのに保存→再オープン後だけ失敗する

・SVGとPNGが同時にあり、fallback地点が分からない

【このKitで得られるもの】

無料記事では、技術的な結論や最小実装まで公開する方針です。

このKitは「答えを見るための商品」ではなく、自分の環境で問題を再現・観測・比較・診断するための実用ツール集です。

収録している主なもの：

・合成SVG fixture

・Browser Clipboard diagnostic

・raw SVG capture

・Windows Clipboard format probe

・SVG Structure Analyzer

・Lifecycle SVG Diff

・Transform Audit

・expected output

・Case記録例

・Direct／Reopen比較workflow

・各種checklist

・実機Reference Evidence

・Security / Privacy / Troubleshooting docs

【重要な考え方】

この問題では、次を分けて考える必要があります。

・SVG MIME present ≠ editable vector

・Excelへ貼れた ≠ Web receiverで安全に受理できる

・SVGとPNGは同時にClipboardへ存在し得る

・Mixed SVGやRaster wrapper SVGも存在する

・Save / Reopen後にSVG byte列やSHAが変わっても、それだけで劣化とは言えない

・serialization差とrendering差は別問題

実機Reference Evidenceでは、Direct／Reopen比較、raw SVG、diagnostic JSON、transform保持、render cross-checkなどを確認しています。

独立rendererでpixel一致するケースもあれば、ごく小さなrender差が出るケースもあります。

そのため「SHAが違う＝劣化」「必ずpixel-perfect」といった単純な判定は採用していません。

【収録物】

■ Web → Excel

・image/svg+xmlを書き込む合成HTML demo

・fixture切替Outbound test

・Outbound checklist

■ Excel → Web

・metadata-only Browser diagnostic

・明示操作時だけ保存するraw SVG local capture

・Windows native Clipboard format enumerator

■ Offline analysis

・SVG Structure Analyzer

・Lifecycle SVG Diff

・Transform Audit

　matrix / translate / scale / rotate / skew / transform list / ancestor presentation transform等

・Expected Output JSON

・実機Reference Evidence

※ CSS transform、viewBox由来の最終CTM、SVGのuse要素の完全展開などはscope外または限定対応です。

■ Documentation

・README / GET_STARTED

・実機試験ガイド

・End-to-End Walkthrough

・Workflow / Tool Guide

・Interpretation Guide

・Filled Case Record

・Troubleshooting

・Security & Privacy

・Regression / Lifecycle / Outbound checklists

【基本workflow】

症状を1文で固定

→ Direction / LifecycleでCase IDを分ける

→ Native / PasteEvent / Async Clipboardを観測

→ 必要な場合だけraw SVGを保存してhashを固定

→ structure / transformをoffline解析

→ receiver rejectとfallbackを記録

→ 1変数だけ変えたcontrolを作る

→ Regressionへ固定

【向いている人】

・Web drawing / diagram / CAD系の開発者

・Office ↔ Web Clipboard実装者

・Excel保存前後で挙動が変わる問題を追いたい人

・SVG Clipboard問題をfixtureとEvidenceで再現したい人

【向いていない人】

・完成済みOffice importer SDKが欲しい人

・全Excel / Browser / Windowsでの互換保証が必要な人

・個別debug代行を求める人

・ファイルをuploadするだけで自動診断するSaaSが欲しい人

【無料記事・Bookとの違い】

無料記事：

技術的な答え、最小コード、失敗の考え方

Zenn Book：

parser / security / lifecycle / regression / release acceptanceを体系的に理解するための内容

Research Kit：

自分の環境をfixture / probe / analyzerで観測・比較・再現するための実用品

【Privacy / Security】

metadata diagnosticはraw本文を保存しません。

raw captureは確認欄と明示操作後だけ元Clipboard Blobをローカル保存します。

合成または保存許可のあるテストデータを使用してください。

metadata diagnostic、raw capture、offline analyzer、native probeはClipboard payloadを外部serverへuploadする設計ではありません。

Outbound fixture toolはsame-originの同梱fixtureだけを対象とし、script、event handler、foreignObject、DTD / ENTITY、external reference、url()参照などを保守的に拒否します。

ただし、これは任意SVGを安全化する一般用途sanitizerではありません。

【動作範囲】

主研究環境はWindows + Chrome + Excelです。

別Excel build、Edge、macOS、Word、PowerPoint等で同じ結果を保証するものではありません。

本KitはOffice内部形式の完全実装ではなく、Clipboard挙動の観測・切り分け・bounded import設計を支援する研究／診断Kitです。

【FAQ】

Q. WebからExcelへSVGを直接貼れますか？

主研究環境ではimage/svg+xmlをClipboard APIでwriteし、Excelへ貼り付けできることを確認しています。ただし全環境保証ではありません。

Q. image/svg+xmlがあればVectorですか？

いいえ。Raster-only SVG wrapperやMixed SVGもあり得ます。MIMEの存在とeditable vectorは別です。

Q. PNGがあるならSVGは無いのですか？

いいえ。Clipboardはmulti-formatで、SVGとPNGが同時に存在できます。

Q. 保存→再オープンすると必ずRasterになりますか？

いいえ。serializationが変わる場合はありますが、byte差だけで劣化とは判断しません。

Q. raw SVGを保存できますか？

できます。明示操作型capture toolで元Clipboard Blob基準のhashとraw SVG、metadata JSONを保存できます。

Q. metadataだけ見ることもできますか？

できます。raw本文を保存しないdiagnostic toolを収録しています。

Q. Pythonは必須ですか？

Analyzerを実行する場合はPython 3が必要です。HTML demo、docs、checklistの閲覧だけなら不要です。

Q. Windows以外でも使えますか？

Python analyzerやdocsは利用できますが、Windows native Clipboard probeとExcel / Windows固有の実機再現はWindowsが必要です。

Q. Clipboard permissionで動きません。

Browser permission、secure context、組織policyを確認してください。policyを回避する手順は提供しません。

Q. 顧客データを使ってよいですか？

最初は完全合成fixtureまたは保存許可のある最小テストデータを推奨します。

Q. 完成済みOffice importerですか？

違います。観測tool、fixture、analysis、Evidence model、checklistを提供する診断Kitです。

【ライセンス概要】

・1購入につき1名のIndividual License

・購入者本人の研究、学習、業務上の内部検証、商用／非商用ソフトウェア設計検討に利用可能

・本Kitそのもの、docs、fixtures、toolsの第三者への再配布・再販売は禁止

・詳細条件は商品ZIP内のLICENSE.mdを優先します