API reference
API リファレンス
公開 import パス、アプリケーションファクトリーの API、互換性のある依存バージョンを調べます。
Effront の API は、アプリケーションの定義、実行環境への接続、ビルド時の統合に分かれています。
ページ、ルート、サービス、Server Function は @effront/core で定義し、実行環境、Markdown、スタイリングには対応するパッケージを使います。
公開 API の一覧
| インポート先 | 主な API | リファレンス |
|---|---|---|
@effront/core | Application、PageViewTransition | Application、コンポーネント |
@effront/core/http | toHttpEffect、makeHttpEffect | ネイティブ HTTP |
@effront/core/workers | createFetchHandler、WorkersRequestContext、Context の読み取り関数 | Fetch と Workers Context |
@effront/cloudflare/workers | CloudflareExecutionContext、Cloudflare Context の読み取り関数 | Fetch と Workers Context |
@effront/server/node | Node.js の serve | Node.js / Bun サーバー |
@effront/server/bun | Bun の serve | Node.js / Bun サーバー |
@effront/server/assets | withAssets | Node.js / Bun サーバー |
@effront/alchemy/cloudflare | applicationHttpEffect、makeApplicationHttpEffect | Alchemy |
@effront/vite | effront、EffrontViteOptions | Vite と Cloudflare プラグイン |
@effront/cloudflare | effrontCloudflare、EffrontCloudflareOptions | Vite と Cloudflare プラグイン |
@effront/server/vite | effrontServer | Node.js / Bun サーバー |
@effront/alchemy/cloudflare/vite | effrontAlchemy | Alchemy |
@effront/markdown | createMarkdownCollection、parseMarkdown、MarkdownError | Markdown |
@effront/tailwind | effrontTailwind | Tailwind |
@effront/markdown/document | MarkdownDocument、MarkdownDocumentProps | Markdown |
@effront/markdown/math | Math | Markdown |
@effront/markdown/mermaid | Mermaid | Markdown |
| @effront/core/query | query、queryAtom、stream、streamAtom、型付き Server Function error | Query Server Function、Stream Server Function |
@effront/core の実行時インポートには react-server 条件が必要です。
ホストプロセス全体でこの条件を有効にせず、effront() が構成するアプリケーショングラフ内で使用してください。
アプリケーションのセットアップは はじめに と プラットフォーム を参照してください。
アプリケーションファクトリーの索引
Application.effront<Services>() は次のファクトリーとメソッドを返します。
関連する定義には、同じファクトリーインスタンスか、そこから withMiddleware で派生したファクトリーを使います。
| メンバー | 戻り値 | リファレンス |
|---|---|---|
Component、Page、Layout、Loading | 描画内容とルート UI の定義 | コンポーネント |
Routes、Middleware | ルートグループとスコープ付きリクエストミドルウェア | Routes と Middleware |
ServerFn | Schema で検証する Server Function | ServerFn |
withMiddleware | 同じアプリケーション ID を保ち、ミドルウェアを追加した派生ファクトリー | Application |
make | アプリケーション定義。サーバーの起動は行わない | Application |
依存バージョン一覧
| パッケージ群 | バージョン |
|---|---|
| すべての Effront パッケージ | 0.2.0 |
react、react-dom | 19.3.0 |
@vitejs/plugin-rsc | 0.5.35 |
effect、@effect/platform-browser、ホスト別 Effect パッケージ | 4.0.0-rc.116 |
alchemy | 2.0.0-beta.79 |
@comark/react | 0.6.2 |
任意のアダプターや連携パッケージを含め、Effront のバージョンを統一してください。
React と React DOM は同じバージョンが必要で、@vitejs/plugin-rsc@0.5.35 は対応する 19.3.0 の RSC トランスポートを含みます。
ViewTransition と addTransitionType は React 19.3.0 の安定版 API です。
Effect 系のバージョンも統一してください。
Vite 連携の公開 Vite peer dependency は * です。
セットアップガイドでは VitePlus を使用します。