dream-num/univerの導入と判断材料

Univerが組み込む三つの編集面

dream-num/univer は、Univer を別のプロダクト内でオフィスアプリケーションを構築するためのオープンソース SDK としてパッケージした TypeScript モノレポである。README はこれをフルスタックかつアイソモーフィックと説明しており、同じアーキテクチャでブラウザと Node.js の両方においてスプレッドシート、ドキュメント、プレゼンテーションの体験を支えることを意図している。構成要素はプラグインシステム、Canvas ベースのレンダリング、数式エンジン、Facade API である。README は Univer が単なるスプレッドシートビューアではないと明示し、SDK をプロダクティビティサーフェスを構築するためのフレームワークとして位置づけている。README が挙げるユースケースには、SaaS 製品、社内ツール、BI ワークフロー、AI アプリケーションへのエディタ埋め込みと、サーバーサイドでのワークブック・ドキュメント処理が含まれる。

dream-num/univerを読むとき、最初に確認する対象はスプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIです。READMEの機能紹介を一般論へ広げず、ここに挙げた名前がどの処理、ファイル、実行環境へ結び付くかを追います。機能があるという記載と、手元の構成で同じ結果を得られるという判断は分ける必要があります。資料に書かれていない性能値や対応範囲は補いません。 dream-num/univerの第1章として、対象の設定と出力を具体的に照合します。

dream-num/univerの構成には、利用者が自分のアプリや環境で補う部分があります。認証、保存先、権限、ネットワーク、ハードウェア条件など、READMEが説明していない項目を既定値として扱わないことが大切です。未記載の点は未確認として残し、実際に使う境界を小さな例で確認します。 dream-num/univerの確認項目1として、失敗時のログと版を残します。

Webとサーバーの責務

README は冒頭で三つの構造的な主張を述べている: Canvas ベースのレンダリングと専用の数式エンジンで複雑なワークブックの応答性を保つこと、すべての機能をコンポーザブルなプラグインとして提供し追加・削除・置換・遅延読み込みを可能にすること、そしてワークブック、レンジ、数式、ドキュメントをブラウザと Node.js の両方でカバーする統一 Facade API を持つことである。ヘッドレスモードはこの設計の Node.js 側であり、README は UI なしのサーバーサイドでのワークブック・ドキュメント処理、数式計算、自動化を説明している。同じアーキテクチャは AI インフラにも向けられており、ワークブックとドキュメントのロジックを Node.js で実行してエージェントやサーバーサイドワークフローを支えるとされている。

導入の入口はスプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIにありますが、コマンドを一度通すだけでは採用判断になりません。入力を固定し、生成物、ログ、終了状態を保存して、再実行したときの差を見ます。設定を変更した場合は変更箇所を一つに絞ります。これなら、依存関係の問題とプロジェクト固有の失敗を切り分けられます。 dream-num/univerの第2章として、対象の設定と出力を具体的に照合します。

比較対象を置くなら、dream-num/univerと既存の方法へ同じ入力を渡します。結果の見た目だけでなく、エラー、再現性、更新時の差分を確認します。別の道具が優れていると決めつけるのではなく、スプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIを必要とする理由があるかを操作単位で判断します。 dream-num/univerの確認項目2として、失敗時のログと版を残します。

表計算データを保存する境界

クイックスタートでは、Univer をアプリケーションに組み込む二つの方法が示されている。推奨されるプリセットモードは、別リポジトリの univer-presets が提供する厳選プラグインバンドルを使うもので、README に示されたコマンドは `pnpm add @univerjs/presets @univerjs/preset-sheets-core` であり、続いて `createUniver` を呼び出してシートコアプリセットを登録しワークブックを作成する。プラグインモードは手動での構成向けで、README は 11 個の `@univerjs/*` パッケージに対する `pnpm add` を示し、その後 `Univer` インスタンスを明示的に構築し、各プラグインを順番に登録し、`FUniver.newAPI(univer)` で Facade API を作成する。どちらの経路でもページコンテナが必要で、README は `<div id="app" style="height: 100vh"></div>` 要素を示している。また、すべての `@univerjs/*` パッケージは同じバージョンに揃えるべきとしている。

dream-num/univerの構成には、利用者が自分のアプリや環境で補う部分があります。認証、保存先、権限、ネットワーク、ハードウェア条件など、READMEが説明していない項目を既定値として扱わないことが大切です。未記載の点は未確認として残し、実際に使う境界を小さな例で確認します。 dream-num/univerの第3章として、対象の設定と出力を具体的に照合します。

保守では、スプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIの版を固定してから更新します。リリースの変更点、依存するランタイム、設定ファイルの形式を確認し、古い成果物を残した状態で新しい版を試します。更新が成功しても、以前の入力が同じ出力や認証結果になるとは限りません。 dream-num/univerの確認項目3として、失敗時のログと版を残します。

文書とスライドの確認点

README は、Univer が Chrome 88 をコンパイルターゲットとしており、Edge >=88、Firefox >=90、Chrome >=88、Safari >=14.1、Electron >=12 での動作を目指していると述べている。`Intl.Segmenter` に依存するため、ランタイムがこれを提供しない場合は `@formatjs/intl-segmenter` などのポリフィルを追加することを推奨している。推奨ビルドツールは Vite、esbuild、Webpack 5 で、package.json の `exports` フィールドに対応しないビルドツール（Webpack 4 など）では追加のパスマッピングが必要になる可能性がある。ビュー層は React 18 で構築されており、React 18 と 19 をサポートし、React 16.9 以降と 17 に対して最小限の互換性を提供する。ヘッドレス Univer は Node.js >=18.17.0 を必要とし、このモノレポの開発には Node.js >=22.18 と pnpm >=10 が必要である。

比較対象を置くなら、dream-num/univerと既存の方法へ同じ入力を渡します。結果の見た目だけでなく、エラー、再現性、更新時の差分を確認します。別の道具が優れていると決めつけるのではなく、スプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIを必要とする理由があるかを操作単位で判断します。 dream-num/univerの第4章として、対象の設定と出力を具体的に照合します。

不向きなケースも明確です。dream-num/univerに記載された入口だけを見て、全てのOS、モデル、プリンタ、拡張、資産、認証方式を扱えると考える用途には根拠がありません。対象を限定できない場合は、必要な操作を列挙してから対応状況を調べるべきです。 dream-num/univerの確認項目4として、失敗時のログと版を残します。

依存パッケージの保守範囲

README の機能表は、オープンソースの機能と Univer Pro の拡張を分けて列挙している。スプレッドシートは最も成熟したサーフェスとされ、オープンソース側にはワークブック、ワークシート、レンジ、選択、数式、数値書式、フィルタ、ソート、データ検証、条件付き書式、ハイパーリンク、コメント、検索と置換、メモ、テーブル、図形統合、拡張可能な UI プラグインが含まれる。ドキュメントはリッチなドキュメントモデル、編集 UI、リスト、ハイパーリンク、コメント、クイックインサートをカバーする。スライドは活発に開発中とされ、プレゼンテーションのデータモデルと UI パッケージが提供される。Bases は、同じプラグイン、コマンド、モデルアーキテクチャの上にカスタムの構造化データ体験を構築する方法として提示されている。README はこれらのサーフェスのリリース日や成熟度の指標を提供していない。

保守では、スプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIの版を固定してから更新します。リリースの変更点、依存するランタイム、設定ファイルの形式を確認し、古い成果物を残した状態で新しい版を試します。更新が成功しても、以前の入力が同じ出力や認証結果になるとは限りません。 dream-num/univerの第5章として、対象の設定と出力を具体的に照合します。

最初の実証はスプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIを使った最小構成です。入力と版を記録し、成功した場合は出力の意味を確認し、失敗した場合はログと設定を残します。dream-num/univerを採用する根拠は、宣伝文句ではなく、その具体的な操作が自分の要件を満たしたかどうかに置きます。 dream-num/univerの確認項目5として、失敗時のログと版を残します。

組み込み基盤としての判定

このリポジトリにはオープンソースコアとファーストパーティの OSS プラグインが含まれており、Univer Pro は商用拡張レイヤーとして別途開発されている。README は境界の原則を述べている: OSS パッケージは Apache-2.0 の下で単独で利用できることを意図し、Pro は公開 OSS SDK API の利用に必須ではなく、OSS パッケージのバグやセキュリティ問題は OSS リポジトリで報告・修正し、OSS ドキュメントは公開パッケージに Pro 専用機能があることを示唆すべきではない。ライセンスは Apache-2.0 であり、著作権は DreamNum Co., Ltd. が 2021 年から保持している。ライセンス抜粋は、永続的で全世界的、非独占的、無償、ロイヤリティフリー、取消不能な著作権ライセンス、特許ライセンス、再配布条件を付与している。抜粋は保証と責任制限の条項の前で終わっており、ソース資料は保証、サポート、セキュリティ態勢について何も述べていない。これらは完全なライセンス本文とセキュリティポリシーで確認すべき事項である。

不向きなケースも明確です。dream-num/univerに記載された入口だけを見て、全てのOS、モデル、プリンタ、拡張、資産、認証方式を扱えると考える用途には根拠がありません。対象を限定できない場合は、必要な操作を列挙してから対応状況を調べるべきです。 dream-num/univerの第6章として、対象の設定と出力を具体的に照合します。

dream-num/univerを読むとき、最初に確認する対象はスプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIです。READMEの機能紹介を一般論へ広げず、ここに挙げた名前がどの処理、ファイル、実行環境へ結び付くかを追います。機能があるという記載と、手元の構成で同じ結果を得られるという判断は分ける必要があります。資料に書かれていない性能値や対応範囲は補いません。 dream-num/univerの確認項目6として、失敗時のログと版を残します。

編集部の結論

dream-num/univerはREADMEに記載されたスプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIを必要とし、対象環境を限定して確認できる利用者に向いています。汎用的な代替や全機能の互換性を求める人には、そのまま適用できません。最初にスプレッドシート、ワードプロセッサ、プレゼンテーション、Web、server、ブラウザ、保存APIを小さな検証環境で実行し、入力、出力、ログ、版、ライセンス条件を確認したうえで採用範囲を決めてください。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes